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With VNC SDK you can connect VNC Viewers with VNC Servers } 
easily over the Internet. Using VNC Cloud, no complicated 
network configuration at either end is required! 


What will you create with VNC SDK? 


Check it out here: https://developer.realvnc.com/ 


Getting connected: www.realvnc.com/products/vnc/raspberrypi/ 
For more information contact vncdeveloper@realvnc.com 
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n December last year, British Army 
Air Corps officer Timothy Nigel Peake 
stepped aboard the Soyuz TMA-19M 
to start a six-month mission aboard the 
International Space Station. It was a small step 
across the ISS hatch for Tim, but as the first 
British European Space Agency astronaut it i MISSION aC COMPLISHED 
was a giant leap for the United Kingdom and Be a 
especially the children that dream of one day SUBSCRIBE & = 7 
going to space. " sin f 
Tim wasn’t the only UK-born passenger aboard SEE PAGE 30 FOR DETAILS 
the ISS, though; two Raspberry Pis joined him on 
his mission to carry out experiments developed 
by British schoolchildren. While Tim returned 
to Earth on 18 June, our two intrepid Raspberry 
Pis, Ed and Izzy, remain aboard to continue their 
ongoing mission to inspire and educate children 
all over the world via the Astro Pi programme. 
You can learn all about Astro Pi in our massive 
cover feature starting on page 14, and how Astro 3° THE ULTIMATE RETRO PHONE 
Pi and other educational programmes Tim has 
been involved with have touched the lives of and 
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The balloon reached almost halfway 
to the edge of space, and only a few 
metres short of the 42km prediction 


1837m (41837m) 


A basic case with the bare essentials needed to make things 
work, which is important when you're trying to save weight 


HIGH- 
ee FLYING 


Everyone has been talking about high-altitude 
ballooning this month; here’s why... 


f you’ve paid attention to 

high-altitude ballooning 

(HAB) within the Raspberry 
Pi community, you’ll have no doubt 
heard of Dave Akerman. He’s 
broken records thanks to Pis in 
HABs, specifically ones involving 
the highest altitude amateur live- 
transmitted pictures. It’s very 
specialised, but still spectacular. 

It probably comes as no surprise, 
then, to learn that he’s broken the 
record once again, this time thanks 
to the recently released upgrade 
to the Raspberry Pi Zero. The new 
camera port is a big deal when 
you’re doing something like this. 

“T’d been pleading with 
Eben [Upton] since I first sawa 
prototype of the original Pi Zero. 
Its low weight would be ideal for 
live-imaging HAB applications, 
if only it had a camera port,” 
Dave writes on the Raspberry Pi 
blog. “The camera is the entire 
reason for using a Pi for HAB; if 
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you don’t want pictures, thena 
smaller/lighter/simpler AVR or 
PIC microcontroller will easily 
do the job, and with less battery 
power. I felt that the CSI-less Pi 
Zero was a missed opportunity. 
Eben agreed, and said he would 
try to make it happen.” 


New records 

On launch day, Dave had to wait 
for the weather to clear before 
filling up the balloon, contending 
with some unexpected gusts of 
wind in the process. The predicted 
altitude for the payload before the 
balloon burst was 42km (26 miles), 
which is about double the altitude 
of the U-2 spy plane. Predictions 
weren’t far off; the last photo 
sent from the camera before the 
balloon burst records an altitude 
of 41,837m. Dave believes this 
breaks any previous record he’s 
made, and any others that have 
been made since. 


Last year, Skycademy helped 
teachers around the UK to 

learn about performing HAB 
experiments in their schools. 

It was a huge success, so the 
Raspberry Pi Foundation is 
launching a new Skycademy 
course. The course will take place 
over three days, with the second 
day dedicated to launching and 
tracking a HAB. You can find out 
more information, and apply, 
online: magpi.cc/28J5Vma 
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Aglimpse of Earth from 
space as Sam's SkiPi reaches 
high into the atmosphere 


The Pi Camera Module went 
missing as the balloon burst, so 
if you have a very thorough search 
around Shropshire, you might just 
find the highest-flying Pi camera 
ever/so far. 


A boy and his Pi 


While Dave might be breaking 
more records, a 17-year-old 
student from Monmouth School, 
Sam Sully, was taking his first 
steps into Pi-powered ballooning 
with his own HAB project. After 
seeing Dave’s original Pi in the Sky 
blog in 2012, Sam was eager to give 
it a go, but didn’t have the skills to 
do so at the time. 

“Now, four years later, I’ve 
gained many more skills,” Sam 
tells us. “Last year I received 
an Arkwright Scholarship, 
giving me £300 to spend on 
anything to further my interests 
in engineering and computer 
science. I decided after a while 
that I could now do this project, 
and so I started my research.” 

His research brought him to 
the forums of the Raspberry Pi 
Foundation and to members of 
the UK High Altitude Society 
(UKHAS), where unsurprisingly 
he bumped into Dave as well 


raspberrypi.org/magpi 


as other members. Completing 
his research, Sam built his 
SkiPi on the provided budget, 
using the skills in electronics 
and programming that he had 
developed for the task. 

After two months of work, Sam 
took his payload and balloon toa 
field and filled it up with helium 
for its ascent over Monmouth. 
Dave even came down to spectate 
and give a hand if needed. 

“T programmed the camera to 
take a picture every minute,” Sam 
says. “These were stored on the Pi 
Zero. Then the Pi selected the best 
photos and transmitted them back 
to us. But my focus was on making 
sure I couldn’t lose it.” 

The balloon reached a very 
respectable altitude of 32km 
in about an hour, before falling 
back down to Earth. It took some 
finding, but Sam managed to 
retrieve the payload and the rest 
of the photos. 

“The pictures are beautiful,” 
effuses Sam. “I’ve already shared 
them with people and set one 
as my desktop background. 

It’s an amazing view from up 
there. People have reacted with 
amazement: they are really 
impressed that it actually worked.” 


Pi in the Sky 


The reason we didn't name this news story ‘Pi in the 
Sky’! Dave Akerman came to the community's attention 
when he originally broke that altitude record, using a Pi 
and a webcam, in July 2012. 


Babbage's big jump 

You may remember Felix Baumgartner, who managed 
to fall with so much style he broke the sound barrier. 
Dave tried to recreate this feat at a greater altitude, 
but with a Babbage bear as a passenger. 


Heston Blumenthal’s potato 
As part of top chef Heston Blumenthal'’s Great British 


Food episode on pies, Dave launched a Heston-esque 
potato from a HAB. The potato survived its descent, 
but not Heston’s plans to mash it up for dinner. 
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RASPBERRY Plo 


IN FIRST MONTH 


Biggest monthly sales of Raspberry Pi ever, following the Pi 3 launch 


2,000 of 

the original batch 
of Raspberry 

Pis as they were 
delivered in 2012 


The Raspberry 
Pi has been 
selling ever 
faster since 

its release 
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hen the Raspberry Pi 3 

was launched in February, 

one of the topics that was 
discussed at the press conferences 
was that the Raspberry Pi had 
reached eight million sales. 
This makes it the bestselling 
British computer of all time, 
overtaking the Amstrad PCW line 
of computers. All of this has been 


1 MILLION 

SALES 
With news that Premier Farnell 
had sold 500,000 Raspberry Pis 
itself, estimates for sales from 
RS Components suggested that a 
million had been sold in all, which 
was confirmed later. With the 
Raspberry Pi only launching in 
February of the previous year, it 
was an impressive achievement. 


achieved in four years, with the 
vast majority of these Raspberry Pis 
built in the UK as well. 

It seems the talk of sales during 
the launch of a new product didn’t 
jinx anything, as the Raspberry 
Pi 3 went on to Sell almost 500,000 
units in March; the previous record 
was in March of last year, which 
saw the release of the Raspberry 
Pi 2. Looking at combined sales 
of all Pi models in March 2016, it 
was the bestselling month for the 
SoC computer in its history. You 
may remember that it took about 
a year for the Raspberry Pi to sell 
a million units, so this shows the 
increased reach the Raspberry Pi 
and its educational mission has 
achieved in the last three years. 

With the possibility of different 
models of the Pi 3 coming out, 
it will be interesting to see how 
these exponential increases in 
sales affect the Raspberry Pi. 


2 MILLION SALES 

AND A MOVE TO THE UK 
Nine months after breaking 
the million mark, the 
Raspberry Pi hit two million 
sales in the last week of 
October. 1.25 million of these 
Pis had been made in the UK 
at this point, eclipsing the 
overseas production of the 
original run. 


The eight million number for 


the Raspberry Pi was a big 
milestone, confirming that the 
Raspberry Pi was the bestselling 
British computer ever. The 

next record to beat is the 
Commodore 64, which has sold 
anywhere between 12 million 
and 17 million units, depending 
on what data you believe. Actual 
sales data seems to suggest 
the 12 million number, whereas 
Commodore itself used to 

insist that the C64 sold 400,000 
units a month consistently 

for a few years. 


9 MILLION SALES 

AND A RECORD 
Near the Raspberry Pi’s third 
birthday, the Foundation received 
figures that confirmed the 
Raspberry Pi had sold five million 
units, becoming the fastest-selling 
British computer of all time. From 
a million in one year to four million 
over two years: the sales have 
been impressive. 
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PI WARS 


The popular robot rumble is confirmed for 
another outing, but you’ll have to wait until 2017 


he past two Decembers 

have borne witness to 

tremendous robotic 
competitions of skill and power 
as part of the CamJam’s Pi 
Wars. Mighty robots built by the 
community proved their worth 
through gruelling challenges such 
as following lines, bowling, and 
stopping at the right time. It’s 
a huge amount of fun for those 
competing and spectating, so it’s 
no surprise that a new Pi Wars has 
been announced. 

Missing its usual December slot, 
Pi Wars 3 will be taking place on 
Saturday 1 April 2017. This change 
of date has been made for a very 
good reason, though. 

“We decided to move it a few 
months to allow more schools to be 
able to compete,” Michael Horne, 
co-organiser of the CamJams and 
Pi Wars, tells us. “We found that 


Here's some 
of the things 
the robots 
had to do in 
Pi Wars 2 


ROBOT DUEL 


Taking a page out of Mario Kart's 


book, these Pi-powered robots 
duelled to the pop in this non- 
destructive battle to see which was 
the victor. The full details were kept 


secret until the day. 
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instead of doing robot building 
during curriculum time (how naive 
was that¢!), they were doing it in 
after-school clubs, and September 
to December didn’t give them 
enough time. So, we hoped that 
we’d get more schools interested 
by giving them more time. We’ve 
so far had over 80 teams register 
their interest in competing and 
about a third are schools, so it 
would appear that the change 

of date has been successful - 

at least it has to the extent that 
there’s interest!” 

You can register your interest by 
heading to the Pi Wars site here: 
magpi.cc/25UHMEp. With new 
challenges such as the Minimal 
Maze, Pi Noon, and Slightly 
Deranged Golf, it should be a lot 
of fun. Check out our motor board 
reviews this issue if you’re looking 
for some inspiration. 


OBSTACLE COURSE 


A classic test of manoeuvrability and 


it sounds. 


skill as the robots needed to navigate 
a testing obstacle course, including 
the giant rotating platform created 
by PiBorg. It was more fearsome than 


STRAIGHT-LINE SPEED TEST 
Your robot's gotta go fast in this 
speed challenge, testing out all its 
power in a sprint to the finish. More 
motors and wheels and a bigger 
chassis mean a heavier robot, 
though, so build wisely. 
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This Pi-vision system was designed to help blind 
people, using an ultrasonic distance sensor 


A bigger 
arcade 
cabinet than 
most people 
make witha 
Pi, you can 
just seea 
cheeky Pi 
sticker above 
the screen 
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Using mirrors and good code, a group managed to make a 3D 
experience in Minecraft Pi, with Sonic Pi linked up to it as well 
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COOLEST 
PROJECTS 


Young people convene in Dublin 
to show off their best projects 


n Saturday 18 June 2016, 

Raspberry Pi Foundation 

CEO Philip Colligan and 
community manager Ben Nuttall 
headed to Dublin for the CoderDojo 
Coolest Projects awards. Here, 
loads of young people gathered to 
show off their excellent projects 
for everyone to see. Philip gave a 
Pi-based presentation to start the 
morning, and then it was time to 
see the displays. 

“As we walked around the 
venue, we grew more and more 
impressed by the projects on 
show,” Ben mentions in his blog 
about the event. “We asked each 
exhibiting group to talk us through 
their project, and were genuinely 


impressed by both the projects and 
their presentation.” 

There were a lot of Raspberry 
Pi projects on display, including 
websites, Sonic Pi demos, robots, 
and even an arcade machine: 

“We arrived at a beautiful Pi- 
powered retro gaming console and 
spoke to the maker’s dad. He was 
excited for his son to be able to 
show his project to people from 
the Raspberry Pi Foundation, and 
asked if we could stick around 
to wait for him to return.” Ben 
requested Mega Drive classic 
Golden Axe, which was quickly 
loaded up for him to play. On this 
page are some of the amazing 
projects that Philip and Ben found. 


Where there 
are Raspberry 
Pis, you're sure 
to find robots. 
This one is 
controlled 
“4 witha Wiimote 
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CODERDOUO'’S COOLEST PROJECTS [iy'(270)) 


GET INVOLVED 


How you Caf) help inspire young minds Become a coder, and your code could go to space 


in the next Astro Pi competition 


oderDojo, like Raspberry Pi atone near you. Start a Code Club 
C and Code Club, isallabout (magpi.cc/28NxhYz) at a local 
inspiring and teaching kids primary school, or another venue 
about computing. Ben Nuttallhas like a library or community centre. 


these tips on how you can help Finally, you could also set up a 

with this effort: CoderDojo (magpi.cc/28Nxn2d), 
“If you want to join us in or offer to help at one near you.” 

giving more young people the You can find out about any 

opportunity to learn programming Raspberry Jams that might 

Skills, learn to make things with be near you by checking out our 

computers, and generally hack Events pages, starting on page 

things that didn’t need hacking, 90 of this issue, or by checking 

there are plenty of ways you can the link for Raspberry Jams above \ 

get involved. for a full calendar of events. | | 
“You can set up a Raspberry Maybe you’ll help inspire the i\ i | 

Jam (magpi.cc/28Nxeff) in your next winners of CoderDojo — 

area, or volunteer to help out Coolest Projects... 


Smarti (2) Joucia 


Impossibly thin 
Loves HAITs 
Versatile beyond belief 
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Case for the Pi A+,B+,2,3 and Official Pi Touch DIERISY 


smarticase.com 


pi-top pi-topCEED 


10 Hour Adjustable 

Battery Life Viewing Angles 

tac3 i 

HD Screen HD Screen 

Modular Modular ~ 
Components Components a 


$2 99 excluding VAT $99 excluding VAT 


a 
|= to Check out our education game CEEDuniverse at pi-top.com/Llearn 
Stay up to date with our latest news by following our social media. 
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ver the past six months, 
. the eyes of the nation 
pe have been turned 
_ skyward, hoping to catch a glimpse 
of the ISS as it zooms far overhead. 
It’s not the space station that 
people are looking at, though; it’s 
the man on board representing the 
United Kingdom. Passions have 
been ignited and many people - 
have been inspired, thanks to’ 
the endeavours of British ESA . 
: astronaut Tim Peake. 


Tim wasn’t the only UK passenger 
aboard the ISS; as we’re sure 
you've seen in this magazine, two 
special Raspberry Pis joined him up 
there. The Astro Pis, Ed and Izzy, 
had their own mission to carry 
out experiments coded by British 
school students, some of which Tim 
helped with, and the results have 
been phenomenal. 

On 18 June, Tim finally returned 
to Earth, and told reporters, “It 
was incredible. The best ride I’ve 
been on ever.” While his first 
space flight is over, Ed and Izzy’s 
ride isn’t just yet, as.the Astro Pi 
adventure continues: Here’s what 
they’ve achieved.so far: 
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TIM PEAKE 8 | 


CoSittic 


classroom 


magine being a child back 
in July 1969, when humans 
first set foot on the Moon. 
Watching those grainy black-and- 
white TV images would have been 
both fascinating and inspirational, 
and many a kid would have gone 

to bed that night dreaming of 
becoming an astronaut. 

Since then, space exploration 
has come on in leaps and bounds. 
Scientists aré making exciting new 
discoveries and there are faraway 
plans to put people.on Mars. But 
what’s perhaps just as interesting 
is that we don’t have to be idle 
participants any more. Thanks 
to the Raspberry Pi, children can 
engage with space like never before. 

It wasn’t always going to be that 
way. When plans were made for 
ESA astronaut Tim Peake to travel 
to the International Space Station 
last December, the idea was that 
he would solely work on a twin- 
expedition, educational mission 
called Principia (principia.org.uk). 
It involved conducting experiments 
which can’t be carried out anywhere 
on Earth, looking at. physiology, 
biology, and materials sciencé, as 
well as solar and radiation physics. 

But then the UK Space Agency 
proposed sending Raspberry Pis 
to the ISS with him, allowing 
children to conduct their own 
space experiments. The concept 
of the Astro Pi and its associated 
competition was born and - a week 
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18 June may have’seen the end of Tim Peake’s 186 
days m space, but this is‘only the end of the first 


chapter for Astro Pi 


before Tim made his voyage and 
following 20-months of intense 
work — two Pis equipped with the 
sensor-packed Sense HAT were 
sent skywards. 
Each Pi had a different camera — a 
standard visible spectrum and an 
infrared — and children were invited 
to code them, with the promise that 
the best efforts would be uploaded 
for use by Tim. At their disposal 
was an all-in-one gyroscope, 
accelerometer and magnetometer, 
the Sense HAT’s 8x8 RGB LED 
matrix and temperature, humidity 


Tim worked on many 
science experiments 
while in space and 
especially in the ISS‘s 
Columbus module, 
home of Ed 
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Latest Updates 


Ting, } 


iE 
The Story of Astro Pi: Part == Al 


Three Coding Challenges Update 3D printed lid variant 


For more information on the individual experiments, and to watch the Astro Pi 


video series, head to astro-pi.org 
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In space, everyone can see your selfie 


and barometric pressure sensors. 
The children used them to come up 
with some marvellous experiments. 


In total, seven experiments were 
chosen: two winners from students 
aged.11 and under, two from those 
11 to 14; two more from 14 to 16, and 
one from 16 to 18. Each winning 
experiment fitted well into Tim’s 


overall remit of research, and 
they astounded the judges. ‘Crew 
Detector’ by Cranmere Code Club, 
for example, was able to check for 
fluctuations in humidity in order 
to see if an astronaut was nearby, 
while ‘SpaceCRAFT’ took data 
logs from the Astro Pi sensors and 
visualised the results in Minecraft. 
‘Trees’ took images of Earth 
in order to analyse plant health; 
‘Watchdog’ by Kieran Wand 
measured temperature, pressure 
and humidity, and displayed them 
on the LED screen for astronomers 
to check; and ‘Radiation’ by Team 
Arthur, Alexander and Kiran at 
Magdalen College School blanked 
off the visible spectrum camera 
~ so that only high-energy space 
radiation could get through, 
~ allowing for effective monitoring. 
Of course, there was room for 
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fun. Team Terminal from Lincoln 
UTC produced a suite of reaction 
games that could gauge how Tim 
performed over time, and whether 
he was affected by long-term space 
flight. ‘Flags’ used telemetry data 
provided by NORAD, togetherwith 
the real-time.clock on the Astro 

Pi, to predict the ISS’s location. It 
then displayed a flag of the country 
directly beneath the ISS. 


“Flags was this simple thing that 
allowed astronauts to look out of 
their window and know where they 
were orbiting over,” says Libby 
Jackson from the UK Space Agency. 
“The children worked out how to do 
that using three-line element data 
and it was a great example of what 
the project could do.” Libby was 
amazed by the creativity on display 
and the way young minds solve 
problems. “They came up with 
things that blew our minds; things 
that we had never thought of”’. 


The experiments ran during 
February and March, and they were 
classed as prime activities. This 
meant they were carried out as part 
of the four hours in the mission _ 
set aside for educational pursuits. 
On top of that, Tim could use his 


MUSIC TO TIM'S EARS 


Space is great, but it's tricky to update your MP3 
player from the ISS. Dave Honess sprung into action 
to provide Tim with some fresh beats by launching 

a new competition. This 2016 Coding Competition 
tasked students with turning the Astro Pi into an MP3 
player, or to produce some original music using Sonic 
Pi (sonic-pi.net). 


PLAY THAT FUNKY MUSIC 


Lowena Hull's MP3 player allowed Tim to shake the 
Astro Pi to adjust the volume and skip tracks. “I was 
dubious about the tilt mechanism working well in 
microgravity using the accelerometers to change 
tracks, but it worked brilliantly,” Tim says. “I tried 
inputting motion in other axes to test the stability 
and it was rock solid — it only worked with the correct 
motion.” But all were amazing: Marcus Panchal's 
iSpace showed playback progress, Joe Spears’ MP3 
player included a Red Dwarf alarm clock and cool 
patterns, and Jude Young's Astro MP3 Player had 
functional buttons and LED patterns. 


ol 
Jude Young was the creator 
of the Astro MP3 Player 


Joe Spears’ MP3 player 
had a Red Dwarf theme 


LET'S JAM 


The Sonic Pi tunes were great, too. Pinal Parmar came 
up with Keep Calm and Dance, while Iris and Joseph 
Mitchell of the Southend Raspberry Jam produced Run 
To The Stars and included a funky piano, bass drums, 
cymbals, squelchy bass, and ‘alien tune’ loops. Isaac 
Ingram’'s Final Frontier was complex (“The key was to 
make the drum beat and then develop the music around 
it," explains his father, Karl), while the development of 
Jamie Andrews’ Piano Pi “was based around the chords 
used throughout,” says his father, Jason. 


The Mitchells produce 
their Sonic Pi track, 
Run To The Stars 


The creator of Final Frontier, |lsaac 
Ingram, started with a drum beat 
and built the song from there 
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SKY-PI THINKING 


Astro Pi has encouraged children 

to think about the importance of 
coding within the space industry. 
Libby Jackson, the UK Space 
Agency's astronaut flight education 
programme manager, says: “Pis 
have been used in satellites, the ISS 


reserve activity time — another 
four hours which, as long as there 
wasn’t a pressing emergency, was 
available for any Pi projects if he so 
wished. But Tim also used Astro Pi 
during his days off. It underlined 
the fact that Tim loved his time 
with the Raspberry Pi and that it 
has proven to be useful. 

“That’s where Astro Pi got a big 
win,” says Dave Honess, education 
resource engineer at the Raspberry 
Pi Foundation. “Tim was motivated 
and interested in Astro Pi, and 
he engaged with it himself ona 
personal devel.” Whenever Tim 
used the Pi, Dave would get a daily 
operations report from the ground 
control team, detailing what he 
had done. “There may have been 
other things he was doing in his 
own time, such as using the suite 
of reaction games,” Dave says. “We 
know he was very engaged.” 

To ease the burden on Tim’s time, 
the programs ran automatically. 


EXPERIMENT DATES 


Crew Detector 2 February to 9 February Visible spectrum camera Columbus module 
SpaceCRAFT 9 February to 16 February Visible spectrum camera Columbus module 
Flags . 16 February to 23 February Infrared Node 2 

Trees 23 February to 25 February Infrared Node 2 

Watchdog 29 February to 7 March Visible spectrum camera Columbus module 
Reaction Games 03 March to 3 March Visible spectrum camera Columbus module 
Radiation 7 March to 14 March Visible soectrum camera Columbus module 
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has computers with millions of lines 
of code, software is needed for the 
next Mars Rover, and we need solid 
programs for the service module 
for the Orion spacecraft. There 

are lots of opportunities.” Libby is 
actually the one to thank for Astro 
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Tim simply had to select an 
experiment from an app called the 
Master Control Program, which 
was on board the Astro Pi. But 

he threw himself into the tasks, 


ASTRO PI USED 


Pi's existence in the first place; 

when she was interviewed for 

her job at the UK Space Agency, 

she pitched an idea for doing A 
something with Raspberry Pi on 

the ISS. This kernel of an idea is 

what eventually became Astro Pi. 


AstroPi Vis | 
P/N AP-VIS-01 : ESA 


Here's Ed, codename 
Astro Pi Vis, after he was 
unpacked, ready to start 
running some experiments 
in the name of science 
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using social media and videos to 
showcase what he was doing with 
the children’s work. 

“T’ve been amazed at how 
many kids and adults have been 
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of course Astro Pi has been a huge Eben believes it showed the 
part of that.” ereat potential of commercial, 
One person who is certainly off-the-shelf technology in space 
vee pleased at how well Astro Pi did is applications. “We hope to see 
Tim Peake is now back on Earth and is going Raspberry Pi founder Eben Upton, Raspberry Pi-derived hardware 
Where Edandzarwillbewating Who Said the entire experiment in CubeSats in low earth orbit 
reminded-him of the excitement and maybe beyond: we’ve been 
encouraged and inspired to he felt about space as a child wondering if SpaceX have any room 
take up programming and look back in the 1980s. “Inspiring a on their Red Dragon mission in 
at science in a different way,” new generation of scientists and 2018,” he comments. 
effuses Tim. “Libby told me that engineers has always been a key Given that the Astro Pi was 
the UK Space Agency has now part of the Principia mission, and one of the fastest ever projects 
engaged with over a million school Tim made space travel as cool for deployed to the ISS, you sense 
children during this misSion, and British children today.” anything is possible. 


DAY IN THE LIFE OF AN ISS ASTRONAUT 
Pex 


Astronauts work to the GMT a More science experiments 
time zone. They wake at 6am re are performed as work 

in their soundproofed cabins, o continues after lunch. 
have breakfast, and catch up —_ | 

with messages. a Ell ~ 6om 


An extra exercise session 
y X caps off the astronauts’ 
Daily planning | % working day. 
conference begins with | | 
the astronauts talking i Me 7om 


through the tasks ahead. 
Second daily planning 


conference to discuss the 
day's events. 


Work starts on science 
experiments and other , mC 
duties set for them. / ,. f 
X VG 7.30pm 


Meal and leisure time. 
Astronauts watch TV or 
work on cool stuff such as 
Astro Pi. 


Exercise is crucial to 
avoid muscle wastage. 


9.30pm 


Time to sleep. 
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Replicating the movements of the ISS and its environment in a Minecraft wotld 


Creators 


» Hannah 
Belshaw, at 
Cumnor House 
Girls School 


Dates 


» 9 February to 
16 February 
2016 


Astro Pi 


» Astro Pi Vis 
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A look at the collation of the data as it came through via the SpaceCRAFT experiment 


n order to better 
understand a complex 
concept, bringing it 
back down to earth can help 
enormously. And so it proved when 
Jon Belshaw was talking to his 
daughter, Hannah, about space, 
the ISS, and the ability of the Astro 
Pi’s magnetometer to measure the 
Earth’s magnetic field. “Can’t we 
just do it in Minecraft?” she asked 
him, firmly seeding an idea that 
would grow to be a winner. 

Jon had already shown Hannah 
how to program blocks in Python, 


Hannah says 


and create shapes such as spheres 
of sand which dropped under 
gravity in Minecraft. But with 
SpaceCRAFT, the concept was to 
log information from the Astro 
Pi’s sensors every ten seconds, 
laying down row upon row of data 
in a CSV file. Upon the return of 
the document from orbit, Hannah 
envisaged opening it in Minécraft 
and playing it back, effectively 
using the-block-building game as a 
data visualisation tool. 

To advance the idea, Hannah 


‘had a Skype meeting with Martin 


O’Hanlon, a Picademy trainer 
and co-author of Adventures in 
Minecraft. She discussed writing 
Python code to animate a small 
version of the ISS and animated 
gauges for the environmental 
sensors. There would also be 

a long-term data logger anda 
playback-function. Martin wrote 
the code and sent it back to 
Hannah for her to look at. 

When the code was ready, it 
was sent to the ISS. “It was a 
gateway idea, because children 
love the open-world nature of 
Minecraft and the ability to freely 
construct their own world,” says 
Jon Belshaw. “The ability to build 
in Minecraft with Python code 
shows children they don’t only 
have to consume technology, 
they can actively produce it 
themselves, which is a powerful 
lesson’for them.” 


Expected results 

According to Jon, the idea.was 

to make young people think 
about science and technology 
and engage with it more directly. 
“They can think about what 
microgravity means, and the 
distances, speeds, and energy 
required to lift someone up to 


| had some amazing experiences because of this 
project, like starting my own coding club at my 
school, visiting Surrey Satellites, and best of all 
being able to meefzFim Peake 
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THE SCIENCE 


There were three main components to the SoaceCRAFT experiment. 
During its development, Hannah Belshaw sought to collect and use 
data that would look at the internal environmentals of the ISS, allowing 

it to monitor pressure, temperature, and humidity. The experiment 

also sought to look at the microgravity environment by using the 
accelerometers of Astro Pi. Finally, it was envisaged that it would analyse 
the magnetic environment, including any local effects and the Earth's 
magnetic field. Hannah's father, Jon, has also coded an Astro Pi data 
browser, which you can see by visiting magpi.cc/1irvC4WA. 
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space,” he says. Both he and 


Hannah expected to see “mainly 
internal effects”, although they 
also hoped to see “the occasional 
engine burn as acceleration”. 


SpaceCRAFT was a resounding 
success, laying down 60,481 
rows of data in a mammoth 
25MB CSV file. It allowed for 
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A CSV spreadsheet 
file was created from 
the raw collected 
data, which could be 
loaded into Minecraft 
to produce a visual 
representation 


some amazing animated visuals 
within the game. “There’s a big 
blocky ISS in the sky that tilts 
and rolls, depending on what it 
was doing according to.the data,” 
explains Dave Honess, education 
resource engineer at the Raspberry 
Pi Foundation. 

“The internal environment 
can be seen, and you can See a 
variation as the ISS goes in and 
out of sunlight;” Jon adds. “The 
most obvious result is the Earth’s 
magnetic field, which is clearly 
seen varying with the orbit. We 
didn’t see an obvious acceleration 
event, which shows how good the 
microgravity environment is on 
the ISS.” 

Hannah’s success in the 
competition also led to her 
new school, Lingfield Notre 
Dame, setting up a Code Club, 
introducing a whole year of 
children to Astro Pi coding. 


* Here's Hannah, — 
the creator of 

* SpaceCRAFT, witha 
test Astro Pi flight unit 


July 2016, 21 


feature | MISSION ACCOMPLISHED 


oo /\ detector 


Snapping away at astronauts on board the ISS by detecting changes in humidity 


Creators 


» Cranmere 
Code Club, 
at Cranmere 
Primary School 


Dates 
» 2 February to 


9 February 2016 


Astro Pi 
» Astro Pi Vis 


jithout being asked 
= 
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When the Crew Detector felt someone's 
presence, the astronaut — invariably Tim —- 
could press a button and pose for a picture 


m has been caught in action - if the 
tor was left long enough, it snapped 


riginally called Sweaty 
Astronaut, this fun 
project sought to use 

the environmental sensors of the’ 
Astro Pi to detect the presence of 
a crew member on board the ISS. 


- By monitoring fluctuations in - 


the humidity sensor, a message 
would scroll across the LED screen 


* asking if someone was there. A 
picture would then be taken using 


the camera, andtheideawas °° 
to see how many shots it would 
eventually be able to capture 
The concept for Crew Detector 

scame from Cranmere Primary 
School pupil, Jasper Hayler- ° 
Goodall. He, along with all 
members-of the Cranmere Code 
Club, had been encouraged 

by teacher Richard Hayler to 
submit an entry to the Astro 

Pi competition. When the club 
found it had won, the children 
decided to code the experiment 
themselves, and it made for a true 
collaborative effort. 


The head Russian cosmonaut, Mikhail 
Kornienko, is captured by the Crew Detector 


“T still can’t quite believe 
that the code we wrote in the 
computing suite at the school has 
been run on the ISS,” says Richard. 
“The Cranmere boys and girls 
were determined from the outset 
.that they would do it themselves 
i when — and not if — they won. I'was 
also impressed by their attention 
to detail, especially the usability *_ 
of the program. They clearly felt a_ 
real sense of ownership over the 
code, and.wanted it to work they 
way they thought best.” 
Expected résuits 
The team members didn’t 
have a.set number of expected 
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photographs in their head, but 
they implemented measures 
that would help to increase their 
chance of success. So, while 
the code would try to catch an 
astronaut’s attention if it believed 
one had been detected, prompting 
them to pose for a photo, if it was 
ignored then the AstroPi would 
Snap away regardless after a 
few seconds. 

The resulting data was logged 
in a file. “We were hoping to be 
able to plot graphs of humidity 
readings and see spikes indicating 
a change.in humidity,” Richard 
adds. “The times of the peaks 
should correspond to time- 
stamped photos containing a 
friendly spaceman.” As a neat 
bonus, the Sense HAT’s LED 
matrix would display a three- 
minute animation, sequence, 
created by the dozen-strong Code 
Club, upon a positive detection. 


Results 
It. was always going to be a difficult 
project. As Richard:points out, 
the code would have to record 
the baseline humidity just long 
enough to produce an accurate 
trigger threshold. The children 
also had to consider the trigger 
point: if they set the bar too high 
then it would fail to detect anyone, 
and if it was.too low it would 
create too many false positives. 
This had to be done without truly 
knowing the conditions of the ISS. 
But in the end, they received 
nine photographs of British ESA 
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astronaut Tim Peake either posing astronaut in it,” says Richard. The 
or working, in addition to one children presented their results to 
showing just his arm. Another a large auditorium of people at the 
image showed Russian cosmonaut Pi birthday party in March. 
Mikhail Korniyenko’s head in the “The images were mostly Tim 
distance. “We had lovely clean setting it off,’» says Dave Honess. 
plots of humidity with a number “But that’s because it was set 

of peaks every day, and each of up in the European Columbus 
the corresponding photos has an module where Tim works.” 


We Kad lovely clean plots of 
humidity with a number ‘ef 
peaks every day 


Cranmere Code Club proudly show off their Astro Pi certificates 


Jasper Hayler- 


Goodall came up with 
the idea for the Crew 


Detector entry 
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Mapping-the environrhental health of Earth in sreat detail from the ISS 


ne of the advantages 

of considering the 

wider implications and 
applications of space is the ability 
to think big and see the overall 


Creators 


> EnviroPi, at picture of life. Oliver Turnbull 
piseecstilne! certainly thought so, as he took 
inspiration from people who 
Dates were using the Raspberry Pi and 


its infrared camera to monitor 

» 23 February to m : 

35 February environmental change through 

2016 the measurement of plant 
health. “I thought this could be 
.taken to the next level and be 
done in space,” he says. And so 
.the Westminster School pupil 
proposed Trees, which looked to 
use the Astro Pi NoIR camera to 
snap pictures of the ground. 

It was obvious that it was going 
to be an ambitious project from 
the start. Under the team name ° 

EnviroPi and the watchful eye 
of teacher Sam Page, Trees was 
looking to achieve something 
; that’s normally performed by 
_ _ sensitive and expensive devices. 
“By doing this with the extremely 
cheap Raspberry Pi, | hoped to 
show its power in monitoring 
environmental change and 
: damage, and encourage others 
__to set up their own DIY projects 
in helping to monitor it,” 
Oliver says. ; 
To do this, the infrared camera 
was used to take observation 
pictures of the ground and then 
an image processing technique. » 
called Normalised Difference 
Vegetation Index (NDVI) was used. 


Astro Pi 
» Astro PiIR 
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Essentially, this is a measure of 
plant health. Oliver thought it 
would be interesting to compare 
the global data collected from 
the ISS to other environmental 
metrics, such as CO, emissions or 
annual temperature, which can °* 
be found online from the World 
Bank API. 


This snapshot of Earth shows the plant health 
above central Europe, taken on 23 February 


i * 
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Amazing colour was captured by the camera in this 
image taken over Central America 
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But it meant the red and 
infrared data would be saved 

to the same channel, making it 
impossible to distinguish the 
latter. “We had to improvise 

by using an alternative index 
(GLI), which compares the green 
channel to the red channel (G-R)/ 


Expected results Results (G+R),” Oliver reveals. 

Oliver had done his homework: Trees didn’t run as smoothy Despite the setback, more than 
he took off in a light aircraft to as expected. In order for the 4,000 photos were sent back. And 
test the experiment, holding the experiment to work, a blue filter they were stunning. “Although 
camera out of the window. He needed to be applied to the there’s less definition than with 
was able to process the resulting camera, but it didn’t form part of the NDVI method, it still shows 
images and get an idea of what it the payload to the ISS. It was an some definition. I am still playing 
would be-like with the benefit of essential component, anditlooked around to try and optimise the 
more altitude. Oliver expected to like the project-would be doomed images and to improve the 

see a negative corrélation between ‘(the astronauts even tried to find definition, such as taking into 
NDVI levels (or plant health) in a blue filter on board). In the end, account atmospheric corrections, 
different areas and the amount the Astro Piwas deployed ontothe but hopefully there will be some 
of CO, emissions and average hatch window and ran without it. nice data inthe end.” 


fluctuations of temperature in 


Credit: ESA 
those areas. In order to get a good 
« image of Earth, Tim 
We also hoped to get some Peake stuck the Astro 
strong definition between Pi IR device onto 
; the hatch window of 
different areas of land (for the ISS 


example, very dense forest, 
rainforest, agricultural land, 
forested land) to demonstrate the 
ability of the Raspberry Pi as an 
ecological monitoring device,” 
Oliver adds. “In my tests, we 
managed to get some really strong 
definition between different areas 
of land.” 


Oliver says 
Hopefully this-will help.to inspire others to.take 
environmental monitoring into therr own hands, 
It's pretty amazing to think that [Raspberry Pi] can.’ 


perform the job of something worth hundreds po 
thousands of pots: 
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The future of Astro Pi is very bright 


im has returned to 
Earth and been 

_ reunited 
with his family. 

His legacy will 

carry on, though, 
thanks to the kids 
he’s inspired over 

the past six months, 
and there’s a very real 


possibility he’ll be able 
to go up to the ISS again. As 
for the Astro Pis, their legacy 
is just beginning as they’ll be “sh 
up on the space station for a very / 
long time. y 
“The Astro Pis are staying on 4 
board the ISS until 2022,” Dave  . A IL o- ee 
Honess tells'us. “That’swhen their >: hi. me 
RTC batteries technically expire, ee get ; S. | 
although they'll probably hold - iaeheeae - Ps | | | 
charge for another ten years. At o bord shee and veteran [Italian] » 
that point, we’ll get them down * 3D-printing é astronaut Paolo Nespoli 
from space and retire them to a Speke lila ', _ launches in May 2017.” 
comfy museum somewhere so exponents with i! 3 It’s not just France and Italy 
everyone can go visit them!” * who will get involved with Astro 
.While the Astro Pis were created about the Astro Pis’being involved Pi, though. Thanks to the success 
with the aid of the UK Space, . .with French astronaut Thomas — of Astro Pi, the ESA is rolling 
Agency with Tim’s stayin mind, .  ‘Pesquet’s mission onthe ISS. .out Astro Pi-related education © 
: their ability to stay operational “The ESA has AstroPi * © > ie resources to all ESA member 
for another 6-16 years-on the ISS educational plans for. the Bex two states, which is’currently 22 
_means that other plans sprang up astronauts that are going mney countries, exponentially expanding 
for them. In March 2016, the ESA *~ Dave.reveals. “Thomas Pesquet is the’educational reach of the Astro | 
got in contact with the Foundation * launching in November this year, Pi project. . ° 
: “Each ESA member state has © 
The ESA has Astro Pi educational plans something called an ESERO office; 
‘ : these provide free resources, | © » 
for the next two astronauts that are: support and information for 
a teachers to enhance STEM subjects 
ond Up to the ISS . : : using space as acontext,” ait 
25 2 July 2016 : — ‘ raspberrypiorg/magpi =, 


Dave. “We’re working with ESA to 
distribute hundreds of boxed Astro 
Pi kits around Europe through these 
ESERO offices. They will have a 
range of supporting educational 
material in the local languages, so 
they could be coming to a school 
near you!” 

There’s not just educational 
plans for the Astro Pis either — their 
usefulness hasn’t gone unnoticed 
by the rest of the space agencies 
that make use of the ISS, as 
Dave explains: 

“ESA operations are also 
planning to use the Astro Pi payload 
for a number of utilitarian, non- 
educational applications. These 
plans are currently in flux, but may 
represent a more longer-term use 
for the payload for when there are 
no ESA crew members on board 
the ISS. One idea is for them to 
be ‘delay-tolerant networking 
download servers’ for the JSL. 
Downloading large amounts of 
data to the ground usually ties up a 
laptop, but because the Astro Pi OS 
is a derivative of Debian Linux, they 
can easily be configured for this 
task. They would have a large USB 
hard disk.connected, which would 
be shared over the JSL network, 
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GROUND CONTROL 


TO ED AND IZZY? 


On g June 2016, Tim Peake connected one of the Astro Pi computers to 
the ISS Joint Station LAN using a £4,000 Ethernet cable, whereupon it 
was remotely accessed by ground control in Switzerland. To accomplish 
this, a double VPN is used along with a Ku band radio link bounced 

off a number of satellites in orbit. Firstly, they VPN into the ESA private 
network, and from there they open another VPN across the Atlantic toa 
NASA computer called the MPCC ground node. That machine uses the 
Ku band radio link and has IP connectivity to everything on the ISS Joint 
Station LAN. Basically, you can now talk to the Astro Pi from a computer 
on the ground. 
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ESA/NASA 
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Putting on events 


so kids could talk 


* to Tim; parts of the 
ARISS system used 
* Raspberry Pis suchas 


the display here 


July 2016. 


* around the country” 
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This won't be the end of Tim's 


relationship with the space- 


venturing P1s 


and anything copied over by the 
crew would be slowly synchronised 
to the ground... This means the 
payload would be contributing 

to the daily operations of the 

ISS, and could pave the way for 
more Raspberry Pi hardware in 

the future.” 

The next stage of Astro Pi for 
the Foundation is the roll-out 
of Astro Pi kits and educational 
resources to the other ESA 
countries, as mentioned. This 
involves translating resources 


French ESA astronaut Thomas Pesquet will be the 
next face you see working with the Astro Pi 
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into multiple languages, as well as 
doing competitions in the other 
countries, so Dave’s work is still 
very much ongoing even though 
the first phase has ended. 

“T can honestly say that Astro 
Pi is one of the best things I’ve 
contributed to,” Dave tells us. 
“Tt’s been a huge collaborative 
effort from the start. It’s had 
input from educators, designers, 
engineers, aerospace companies, 
and international space agencies. 
For me it’s been hugely gratifying 
to see all these different people 
pull together in the name 
of education.” 

Even with Astro Pi becoming a 
Europe-wide educational mission, 
this won’t be the end of Tim’s 
relationship with the space- _ 
venturing Pis. 

“When Tim Peake flies again © 
(when, not if), we would love to 


‘build a brand new Astro Pi for him. 


It would be faster, better, with 
more LEDs, more sensors, and 
nrore buttons, and would allow a 
wider range of experimentation for 
budding programmers.” 

We can’t wait toreturntothe ° 
final frontier for more experiments 
with Ed and Izzy. 
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~ ASTRO INSPIRED 
Here’s some Raspberry Pi space projects 
that have come about since Astro Pi 


ARISS lets students around the 
world experience the excitement 
of talking directly with the crew 
of the ISS via ham radio. They’re 
Looking to fly a third Astro Pi to 
act as a dedicated composite 
video source for the ham TV, 

so students can watch the 


astronauts talking on the radio. Credit: Norwich Schoo 


Tesat-Spacecom is a German 
aerospace company which is 
investigating the possibility 
of qualifying Raspberry Pi 
computers as a standard 
aerospace part (MIL-PRF-38535, 
ESCCg9000, EEE-INST-002). This 
could enable things like the Pi 
Compute Module to be used as 
a generic part on many different 
spacecraft and satellites in 

the future. 


MaMMoTH-Up is a research 
project developing an 

_ experiment container for 
payloads launching on Ariane 5 
rockets. The container and 

~ the experiment inside it are 
controlled by a computer that» 
provides access to the rocket's 
flight telemetry. Airbus DS has. 
employed an intern to usea , 
Raspberry Pi as the dummy : 
payloadto test this interface. 
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Arecycled USB internet phone acts 
as a digital microphone and is wired 
to the Trimphone's handset 


When the handset is lifted, 
the device automatically 
connects to Amazon's Alexa 
voice search service 


Aspeaker is added to the 
phone to announce the 
results from Alexa 


The Raspberry Pi inside this 1970s telephone calls up Amazon’s Alexa 


AlexaPhone 
meen §=Voice assistant and gets the answers to almost any question 
cheat Apikate-themadle pes Rema artin Manders has a and vital facts like ‘how old is 
language dismantled to provide the phone passion for upcycling Graham Norton°’ or ‘why is the 
pineal A NT vintage technology. sky blue?”. 
anecione He’s well-known for using the “She has a fun side too,” 
ron Sea Raspberry Pi to add ‘smarts’ to Martin tells us, “with a seemingly 
only takes two classic VCR and radio technology, bottomless selection of dad jokes 
seconds to but his latest project, the and preprogrammed responses to 
respond AlexaPhone, makes an old odd questions like ‘would you like 
> The telephone ultra-smart with a to build a snowman:?’.” Beyond the 
Ulin glean connection to Amazon’s Alexa 


» Around 


32 


dial contains 
a tiny amount 
of radioactive 
tritium 


1.6 million 
Trimphones 
were sold 
in the 1970s 


MagPi: July 2016 


voice search system. 

Martin has stripped out a classic 
1970s Trimphone and fitted a 
Raspberry Pi inside. “You lift 
the handset, speak your query, 
and the response from Alexa is 
read out via a built-in speaker,” 
explains Martin. 

Alexa provides users with 
information on the web via voice 
search, including weather, news, 


jokey facade, Alexa also sets timers 
and reminders, plays music, and 
reads audiobooks. 

“T have a real weakness for retro 
design,” says Martin, “especially 
telephones and televisions.” The 
Trimphone was the height of 
technology in the 1970s, replacing 
the bell ring of classic phones with 
an electronic warbler. “I think I 
picked it up at acar boot sale in 
Brighton about 15 years ago,” he 
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recalls. “It proved perfect for the 
AlexaPhone project, as the internal 
wiring has convenient modern 
ribbon cables for connection 

to the Raspberry Pi.” 

Martin used an old USB internet 
phone to connect the Trimphone’s 
microphone to the Raspberry Pi. A 
cheap portable speaker is stripped 
down and fitted inside to play back 
the responses. 

“After some digging around, 

I came across Sam Machin’s 
excellent AlexaPi code on 


The finished project is a stylish 


1970s Trimphone that calls 
Amazon's Alexa service 


‘| " \ " a‘ 4 ; 
: | | | "i ‘ My ‘ 7 " " ; ; ‘ " ‘'\ 
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enabled and headless. Getting all 
of the components to fit inside 
the phone body was a bit of a tight 
Squeeze, but with some liberal 
plastic trimming it came together 
in the end.” 

The only thing Martin 
updated was the name of an 
MP3 file in the script. This was a 
straightforward change so that 
the AlexaPhone would sound its 
signature Trimphone ringtone 
on boot instead of Alexa’s usual 
chirpy ‘Hello!’. 


She has a fun side too, with 
a seemingly bottomless 
selection of dad jokes 


GitHub (magpi.cc/1U6106r),” 
reveals Martin. “It offers Alexa 
integration for the Raspberry Pi 
with a physical button connected 
to the GPIO pins. 

“The AlexaPhone started 
out as a quick distraction,” he 
continues, “but was so much 
fun to build it just took over. 
“T got the AlexaPi software fully 
working on my Raspberry Pi 3 
in the workshop, then repeated 
all the steps, removing cables 
as it gradually became wireless- 
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“ve found it accurate, the voice 
recognition is good, and even 
when I’ve stumbled over words, 
Alexa usually figures out what 
was Said. I have it on my office 
desk and use it nearly every day, 
sometimes to get information, 
but often just asking questions 
out of curiosity to see whether 
Alexa will understand them. She’s 
particularly good at maths as well, 
so the AlexaPhone comes in handy 
for double-checking the kids’ 
homework answers.” 


ALEXAPHONE 


Projects 


BUILDING A RETRO 
VOICE ASSISTANT 


al iy 
- 4, 
Pie Pas. 
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HARRY GONZALEZ-RIVERA 


A system analyst living in 
Texas, Harry likes to take tech 
apart to figure out how it works 
in his spare time. 
magpi.cc/itvSTTr 


The system hooks up over 
RCA cables and can be routed 
through a home theatre setup 


* 


All the system fits inside this 
small, older karaoke mixer 


Plug in a mic and 
you're ready to go 


PI ZERO 
=§ KARAOKE BOX 


month's work 
at weekends 


eee Unimpressed with a consumer karaoke product, 
palaces one Pi user made something far better with a Pi Zero 


second version 

powered by Pi 3 

Vania ertain members of The problem when trying to buy a It turned out to be a conversion 

a Japanese MagPi team like a good commercial karaoke machine. from composite to HDMI. Also, 

portmanteau of bit of karaoke. Africa by “About a year ago, | bought a the USB implementation of the 

peat ke Toro, Disney music, tiie tiene consumer karaoke box that had device [for loading files] was 

orchestra to Mazinger Z — it’s all a bit of fun USB and HDMI for about $140,” poorly programmed.” 

This is Harry's with the right people. Karaoke Harry tells us. “It looked awesome After getting a smart hub for 

first project machines can be expensive, until I actually tried to use it: at home automation, Harry spent 
though, and the cheaper ones lack _ first, the HDMI output created some time trying to get it to 
ereat functionality as well. Harry an audio delay and the output control his TV, and one of his 


Gonzalez-Rivera came across this of the HDMI wasn’t even 1080p. friends joked that he should try 
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to automate the karaoke machine 
as well. Harry ran with the joke: 

“T decided to do some research 
about using an Arduino ora 
Raspberry Pi to control the karaoke 
device, using an IR emitter to 
change songs, or look for a way 
to emulate a USB. I had an old 
Raspberry Pi Model B hanging 
around and remembered my uncle 
had a pretty cheap but cool karaoke 
mixer; I decided to do everything 
using the Pi and continued doing 
some research to see what | would 
need to make it work.” 

The mixer was quite small, so 
the system had to be built to an 
extreme size constraint, hence the 
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Karaoke Pi 


Main Queue 


My Queue 


Favorites 


Now performing: 


use of a Pi Zero. The Pi has a128GB 
SD card, and is accompanied by 

a USB audio card and a USB WiFi 
adapter that are plugged intoa 
small USB hub. All it needs is a mic, 
then you can hook it up toa TV and 
it’s ready to go. 

“Most of the research was done 
on the software side,” Harry 
reveals. “There were a few projects 
that people had worked on, but 
none of them works perfectly 
on the Pi. While researching, I 
came to the conclusion that VLC 
worked perfectly with no resizing, 
so the project runs in the native 
CD-G resolution of 288x192. I 
also wanted to make it as bare- 


The basic system was 
tested before completion - 
not much was needed 


Projects 


bones as possible, 
so it took a lot of trial 
anterior tomnum VEE 
with a pretty basic web back end 
that works perfectly.” 

The full code for Harry’s karaoke 
box is available on GitHub, like all 
eood projects (magpi.cc/1UyX3iZ), 
if you fancy giving it a go yourself. 
The biggest question about this 
project, though, is what is Harry’s 
favourite song to do on karaoke? 

“TI mostly sing La Flaca by Jarabe 
de Palo (I’m from Puerto Rico), 
but in English I have to pick Hotel 
California by The Eagles.” 

LUNE OWONTES Me, aeine Ounce 
you check into karaoke, you can 
iNew eileaie: 


This tiny box 
is unassuming, but 
contains all you 
need to rock out 
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An Arduino is hooked up 
to a DHT sensor to capture 
temperature readings 


» Each hive 
has around 
30,000 bees 


» Valentin owns 
30 hives in total 


The device is housed 
safely inside a sealed 
plastic box with 
switches on the outside 


The Raspberry Pi is used 
to maintain a database of 
temperature readings 


» It took abouta 
month to build 
» It measures the 

temperature 
outside the hive 


» The battery 


lasts around Home-grown honey made with Raspberry Pi sounds tasty to us. 


three days 


The Beehive Server lets 
Valentin know the ideal time 
to collect his honey 
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ees are amazing! They 

build hives, waggle dance 

for each other, and make 
tasty honey, which we then steal 
and turn into Crunchie bars. 

It’s a good job bees make three 
times as much honey as they 
need, given how tasty it is. In 
Summer months the bees are 
busy making honey, which they 
then use as food during the colder 
Winter months. 

Beekeepers aim to snaffle the 
extra honey at just the right time. 
One smart MagPi reader, Valentin 
Petrache, got rid of the guesswork 
and built a smarter beehive. The 
Peckeepilmescivcmilicastics 


Have a slice of this home-built beehive with smart scales and sensors 


the weight and temperature of a 
hive. Valentin then uses the data 
to figure out the exact time to 
harvest his honey. 

“When I first thought of 
the idea,” says Valentin, “I 
made a checklist of important 
information on beekeeping, and 
how to harvest as much honey 
as possible. 

“| measure the outside 
temperature and humidity,” he 
tells us. “It’s important to know 
when the bees are active, and 
to know the hive’s weight. 

“In beekeeping, it’s important 
to keep your hives close to a lawn 
of flowers where bees extract 
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pollen and produce honey. 

If the flowers don’t have enough 
pollen thelbees Starwearming tine 
honey from the hive. Thererore, 
you have to move the hives toa 
better area. So 1 thought, “What 
a great idea to have a weight scale 
under a hive.” 

The Beekeeping Server merges 
different devices and sensors. 
The project contains a Raspberry 
Pi, Arduino board, DHT23 sensor, 
HX-711 scale amplifier board, 
load scale (rated at 300kg), small 
LCD, WiFi dongle, and lithium 
polymer battery. 

“The Arduino board is the core 


of the project,” explains Valentin. 


“It reads the temperature, 
humidity and weight, and prints 
it in a human-friendly format. 
The HX711 amplifier sensor reads 
raw data from the load scale and 
sends it to Arduino in kilograms. 
The DHT sensor reads outdoor 
temperature and humidity, 
and the LCD [displays] weight, 
temperature, and humidity. 
“The Raspberry Pi has the 
role of the server for wireless 
communication,” he continues. 
An Apache server and SQL 
database are set up in Raspbian. 
The Raspberry Pi accesses the 


BEEKEEPING SERVER 
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data on-site. 

“Tt took about a month to 
build,” says Valentin, “and of 
course there were problems.” 
From library issues all the 
way to frying a board, Valentin 
has had his work cut out. 

“At first, | had problems 
with getting a reading from 
the HX711 sensor. My scale had 
different colour codes for the 
four wires it has, and the HX711 
was getting no data. Currently, 
I have problems with the weight 


barrier between the sensor and 
outside temperature.” 

Despite the gremlins, 
Loe ee Cees Sve 1S ia 
constant use. Valentin is ironing 
out the issues and looking 
to add a solar panel soon (the 
battery needs changing every 
three days). 

“It’s fun building one,” he 
tells us. “The process of creating 
something, and the information 


you learn during the build process, 


it’s all very rewarding.” 


know when the 
honey is ready 
to be collected 
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Bee safe 

The Raspberry Pi and Arduino devices are 
placed inside the sealed box, with a switch 
used to turn it on and off. This unit is then 
connected to a weight scale, mounted 

at the bottom of the beehive. 


Box and buttons 

A plastic tub is used as an enclosure 

to protect the parts from the bees. 

A button is connected to pin 12. Pressing 
it activates the backlight so the LCD can 
be read in low light conditions. 


Arduino and DHT sensor 

A DHT (digital humidity and 
temperature) sensor is connected to the 
Arduino on port 10. An LCD is hooked to 
the Arduino, so Valentin can check the 
readings locally at the beehive. 
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Powered by Pi (and 
other things) to connect 
to the Bitcoin network 


eeerreerereeeee 


Visualise a Bitcoin node with a 
great light display that tells you 
how well the current block is 
going in your block chain 
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f you work or pay attention 

to the technology 

industry, you’ll know how 
ubiquitous Bitcoin is. The digital 
currency is big in the tech world, 

» The build took and considering how much Bitcoin 
meena is currently worth, it can be ve 
months y : “J 

advantageous to help mine some of 

> A full list of a as ; | 

it — it’s basically free money! Well, 
components fa) 
can be found minus the expense of the electricity 
here: required to help with the mining. 
emia Raspberry Pis are quite popular for 

Bitcoin uses, but Matthew Zipkin 

» The enclosure hace ener 1 f 
build was fairly ae ae e am J acon lee @ 
new ground for connecting his Pi to Bitcoin. 
Matthew, but “The Bitcoin Block Clock is 
miieneeee 3 Bitcoin full node connected 

eR = tO a 32x32 RGBLED grid, which 
the Pi due to iF t k 
TSSSHene a visua ses cer ain networ 
the community properties in a fun, colourful 

clock-like display,” Matthew 


Visualise the current 
state of the block chain 
with this display 


Interact with the monitor 
clock and even use it as 
a Bitcoin piggy bank 


Height Size Hash 
412772 976,139 00000000000000000458ac39b87a fc 748 fddad92555 34e9C 166529 1680953765 


412776) =: 982, 905 2 80000900000000000 3459 [54 1 7cBaZ 1860094 1 £I9ccac2Z376fclaG4l {[Zea72ZfaB 


412767 8=6594,283 809009990099000003005 9a Shee 143 fWacabe Je fac 19c74ce3d4I5c528d 14a 


412765 984,590 BB89G0000000000000S dea 4ac Ledcce 30372050 16 f bat f6dd fd6c31f6f64fe 


» Matthew is 
currently explains. “So that’s two things: 


building a Bitcoin full node is a computer 


a second, 


Bote cercion that runs the Bitcoin software. 


it COMMAS WO 12) joeeies Cin Wire 
network who also run the same 
software, and together as part of 
the ~7,000-node Bitcoin network 


More 
information is establish the global consensus on 
provided oniuie the block chain, the ledger of all 
screen below 
the display Bitcoin transactions. That software 
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can also send and receive Bitcoin 
transactions, giving my project a 
‘piggy bank’ functionality. You can 
send money to the clock!” 

The LED grid lights up and 
shows a lot of data for the user, 
including current block progress, 
how difficult it is to mine Bitcoins, 
and how much you can mine. It 
may look a little complicated, but 
to those in the know it offers a lot 
of useful info. 

“There are a few companies that 
sell compact Bitcoin full nodes to 
users and hobbyists,” Matthew 
tells us as he explains why he 
made it. “But they’re boring! They 
don’t even have a screen. You just 
plug it into the wall like an air 
freshener and let it do its thing. 
You can SSH into them and do 
technical things, but they really 
provide very little utility to the 
user. There was one company that 
used to make them with a screen 
that at least showed some network 
Statistics, and I wanted one, but 
they went out of business! So I 
decided to make my own.” 

The final product looks great 
and, according to Matthew, works 
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well: “It’s been running non-stop 
ever since I finished it. The SSD 
was a huge help. Lots of compact 
full nodes just use a USB flash 
drive, and that works OK just for 
the Bitcoin stuff. But the other 
functions I wanted my clock to do 
were So Slow, and | discovered the 
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The whole 
system is open 
for all to see: 
no tricks here 


bottleneck was the flash drive. 

It looks awesome and everyone 
who comes into my living room 

is mesmerised by it. It looks like 
some crazy alien clock! You don’t 
need to know anything about 
Bitcoin or computers to appreciate 
that it’s cool.” 
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ESSENTIALS 
LEARN | CODE | MAKE 


AVAILABLE NOW: | 


> CONQUER THE COMMAND LINE 
> EXPERIMENT WITH SENSE HAT 
> MAKE GAMES WITH PYTHON 
> CODE MUSIC WITH SONIC PI 


ESSENTIALS Ma GPi i822: mags 


The 


Milf Pervemsescie From the makers of the 
official Raspberry P1 magazine 


OUT NOW IN PRINT 


ONLY £3.99 


from 


raspberrypl.org/magpl 


GET THEM 
DIGITALLY: 


Tutorial 


You just need two devices 
to get this style of 
automation started 


With built-in Bluetooth 
support, the Pi 3 is perfect 
for this kind of automation 


This can be achieved 
with nothing more 
than a phone as a tag 


CREATE A 
RASPBERRY PI 93 
BLUETOOTH TAG 


Have a Raspberry Pi 3 switch on your computer when you get home 
from work, by looking out for a Bluetooth device 


ffordable automation is just one of the many to show off a simple project by creating a Python 

PyBluez module popular projects for the Raspberry Pi since script that sends a Wake-on-LAN (WoL) magic packet 
magpi.ce/ its release. We can easily see why: it’s small, to your PC wh3en it detects a specific mobile phone's 
1VOuGCy : : : 

easily programmable, and has a huge community Bluetooth signal. 
haenaaseols backing it with software and support. Now that the 
eit aa Pi 3 has built-in Bluetooth, it’s even easier to create >STEP-0O1 
aVOvpDF events to help control your house better. We’re going |§ Prepare your Raspberry Pi 


See eae We’ll need several extra pieces of software added 

ee oe ao ae walk to the Raspberry Pi to get our little system working. 

although you might Both connecting to Bluetooth and sending a Wake- 

need to do a Little bit : : 

of hacking on them on-LAN signal require extra modules for Python. 
First, grab pip — the Python package installer — 

SO we can add them: 


Compatible PC 


Bluetooth dongle 
(optional, only if 
you don't have 

a Pi 3) 


sudo apt-get install python-pip 
Once that’s done, you can install the PyBluez and 
wakeonlan modules with pip, using the following 


two commands: 


sudo pip install pybluez 
sudo pip install wakeonlan 
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bluetooth_tag.py 


#/usr/bin/env python 
import time 

import bluetooth 

from wakeonlan import 


PRONeCH= = teeth Pe 


def search(): 


Tutorial 


PI 3 BLUETOOTH TAG 


qanguage 


Toe = 
Days Gays 8 oC fF 


Status 
>PYTHON 2 Not charging 
DOWNLOAD: Battery level 
magpi.cc/ 50% 
BluetoothTag 

SIM status 


IMEI information 


IP address 


devices = bluetooth.discover_devices(duration = 5, lookup names = True) 


return devices 


while True: 
results = search() 

for addr, name in results: 
if addr == phone: 


Wi-Fi MAC address 


Bluetooth address 
64:bc:0c:ff:fd: bo 


wol.send_ magic packet('ff: ff: ff: ff: ff: fF") 


time.sleep( 22) 


>STEP-02 

Get an address 

We’re going to program the Pi to look out for a specific 
Bluetooth device, using the latter’s MAC address 
for complete accuracy. While creating this tutorial, 
we used an Android phone; for any Android device 
with Bluetooth capabilities, you just need to go to 
‘About phone’ and then ‘Settings’ to find the MAC 
address for the Bluetooth interface. You’ll need to 
look up information specific to your type of phone 
or Bluetooth device on how to find its MAC address. 
Either way, make a note of this address. 


>STEP-03 


Wake up your PC 

Wake-on-LAN is built into many PCs. The wired 
network interface is receptive to the ‘magic packet’ 
that tells it to turn on. However, the WoL packet needs 
a MAC address to look for, rather than an IP address, as 
the PC is off. Boot into the BIOS of your PC; directions 
to do this should be on the splash screen when you turn 
your PC on. Enable Wake-on-LAN if it’s available, then 
boot into your operating system and look up the details 
on your wired network to find the MAC address. 


>STEP-04 

Get coding 

We’re just about ready to get this all working; all 

we need now is the code. Copy it from the listing or 
download it from magpi.cc/BluetoothTag. You’! need 
to edit it a bit on the Raspberry Pi, replacing the MAC 
address for the phone with the device that activates 
the Wake-on-LAN. You’ll also need to edit the MAC 
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Serial number 

Uptime 

93-3000 
address on the linewol.send_ magic packet to be aneve tile! 

— where you can 
that of your PC. Press F5 to give ita test; you may need ___ find the MAC 
: 2 od ; address on an 

to play about with your device’s Bluetooth settings for Radiol ohoné 


it to work properly. 


>STEP-05 

Run at boot 

It won’t be easy to run the script in IDLE all the time 
for this, so it’s best to have the script executed at boot 
time. Assuming this isn’t a Raspberry Pi you’1l be 
using for much desktop work, you should first set it to 
boot to command line and also to automatically log in. 
Once that’s done, open up your user profile with: 


but it will differ 
on other devices 


sudo nano /etc/profile 
...and add this line to the end of the file: 
sudo python /home/py/bluetooth_tag.py & 


Save and exit. Rebooting will start the 
script automatically. 


>STEP-06 

Future edits 

The script is easily upgradeable and expandable. 

You could have it look for multiple Bluetooth devices, 
you could change the timing (how long it checks and 
the time between checks), you can have it senda 
magic packet to multiple systems, etc. That’s just the 
beginning as well: with such triggers, you can set off 
many other automation tasks that can be controlled 
by Python. 
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MAKE A 
DINOSAUR REACT 
TO YOUR EMAIL 


Connex Action 
Dinosaur 
Electronics 

Kit: magpi.cc/ 


1ScJbZX 


LED & 1kKQ and 
330Q resistors 


NPN Darlington 
pair transistor 


Diode 1N4001 


Breadboard 
and cables 


ft ¢# & @ 
* ft & @ @£ 
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Hack a toy dinosaur with Node-RED to provide email notifications 


ant to let the kids know it’s time for dinner by 
waking a toy in their bedroom? Or have a fun 
alert on your desk when you receive an email? 
This project takes you step by step through the process 
of hacking a cheap toy and using a Raspberry Pi, Node- 
RED drag-and-drop visual programming, and simple 
electronics to make a dinosaur move on demand. The 
electronic circuit used in this project can also be used 
to control larger motors, relays, or high power LEDs. 
First step, toy dinosaurs — next step, email control of 
all your home automation devices? 


A Darlington pair transistor 
allows higher currents to 
be switched compared 

to anormal transistor 


se & @) 


* “se @ @ “* * © © 
= . ©! 


Raspberry Pi Model # v1.1 
2 Raspbeny Pi 2014 


This is where 
you put the 
dinosaur motor! 


= 
= 
= 
= 
= 
= 
= 
- 


>STEP-01 

Install Node-RED on your Pi 

Before connecting anything to the GPIO pins of your 
Pi, we’ ll draw the code. If you have the latest version 
of Raspbian Jessie, Node-RED comes installed in your 
Programming folder. If not, you can install it viaa 
terminal (see magpi.cc/28PJz20). You also need the 
Firefox browser. Connect your Pi to the internet, open 
Node-RED (Menu>Programming>Node-RED), and 
paste the address at the top of the Node-RED window 
into Firefox. This address should be something like 
http://192.168.X.XXX :1880. You should now see 

the Node-RED flow page. If you find everything is 
sluggish, you may like to access that address from 
another computer’s browser. 


>STEP-02 

Intro to Node-RED 

If you haven’t used Node-RED before, start by making 
an ‘inject-debug’ flow. Drag an inject node from the 


ry 

‘S : -; Input section of the left menu into the middle pane. 

S Its name should change to timestamp. Repeat witha 

Us ereen debug node from the Output menu. Join the two 
eco Psttishiislllitissrrmrreriift] BYR) dy ticking one of the grey pimples and drag it to the 


pimple on the other node. Click the big red ‘deploy’ 
button at the top-left. Activate the inject node by 
clicking the square to the left of the word timestamp. 
The resulting message (payload) appears in the 
debug tab. 


>STEP-03 

Draw the flow 

Drag the email node with the connector on the right 
into the work area. Double-click it and enter your 
email credentials. Connect a debug to the email node, 


: This diode to check what messages are arriving. The message 
: — _ | Stopsback EMF contains the email text and who it’s from. Drag ina 
damaging the Pi 


Switch node and double-click to make some changes. 
For Rule1, change the ‘==’ to ‘Contains’ and type 


raspberrypi.org/magpi 


Set your dinosaur 
free! There are 
already a few 
dinos in the 

wild - tamed 

by @andysc, 
@neilcford, 
@fortoffee and 
@andypiper 


‘Dinner’ (without quotes) into the text string box. Any 


email that contains the word ‘Dinner’ will output to the 


first (top) output node. Click ‘+ rule’ near the bottom, 


and change ‘==’ to ‘otherwise’. All other messages will 
go to the second (bottom) output node. 


>STEP-04 

Turn the motor on and off 

The message must just be ‘1’ or ‘o’ to turn the motor 
on or off. To change it from the text, add a change 
node and change the message to a1. Connect an 
inject node to the input of the change node. This 
will allow you to text the flow without sending an 
email. Add a delay node and another change node, 
and change the message to zero, otherwise the dino 
won’t stop. Connect both the first change node and 
the delay node to a GPIO out node (connector on 
left). Set the pin to physical pin 37. Deploy the flow. 


>STEP-05 

Make the circuit and dinosaur 

Connect the circuit as shown in the diagram. Turn 

the Pi off before connecting anything to the GPIO pins. 
As this motor is low current, we could use a transistor 
rather than a Darlington pair. However, the latter 
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© connect error 
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HACK A DINOSAUR 


>NODE-RED 


DOWNLOAD: 
magpi.cc/isNeypk 


Above 

The complete 
project. Now 

you just need to 
email ‘Dinner’ 

to get everyone's 
attention 


allows higher currents to be switched, and so this 
circuit can be used for other projects — but never mains 
or AC. Assemble the dinosaur kit. Make sure the dino 
can nod freely. The kit’s battery holder and motor 
connect straight to the breadboard. You don’t need the 
switch. On the Raspberry Pi, use the ground on physical 
pin 39 and GPIO pin 37. 


>STEP-06 

Make dino nod and roar 

Turn the Pi back on and open Node-RED again. 
Click the inject node and the dinosaur should nod. 
Now send an email with ‘Dinner’ in the message 
(not in the subject). The dino should nod again! 

To get your dino to speak, attach a speaker to the 
Raspberry Pi, then add an exec node into the flow. 
You may need to install MPlayer onto the Pi (use 
sudo apt-get install mplayer from a terminal). 
Make sure your ‘roar’ MP3 file is on the Pi. Double- 
click the exec node and type in the command box: 
mplayer /home/pi/.node-red/roar.mp3 


Left This 
Node-RED flow will 
trigger if any email 
is received. The 
delay node stops 
the dino after 

five seconds 


PYTHON 


If you want to 
do this using 
Python, see @ 
ForToffee's blog 
| (magpi.cc/ 
= = 1sNeTZj) or 
delay 5s 0 SE ‘ Chris Robbins’ 
7 (magpi.cc/ 
1sNeMNi. 
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Tutorial 


In this world we added 
snow to the blocks not 
to be transformed (add 


them to the keepblocks 


list in the code) 


The default setting for 
a placed TNT block is 
inert. If you want to be 
able to detonate them, 
you ll have to set their 


data value to 1 


THE HAYLER-GOODALLS 


 / “* Ozzy, Jasper, and Richard are mentors 
at CoderDojo Ham and gave a talk at 

* the Raspberry Pi birthday party about 

their Astro Pi adventures. 

richardhayler.blogspot.co.uk 

@rdhayler / coderdojoham.org 


. 


-* 


> Initial State 
account 
initialstate.com 


> ISStreamer and 
Python 3 library 


> psutil Python 3 
library 
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Everyone has their favourite Minecraft block. 
What if you could have an entire world made out of them? 


magine fields of gold, fit for King Midas or 

the dragon Smaug. Or how about a frozen 

landscape where everything has been turned 
to icee Just think what you could do in a world where 
everything is primed TNT. 

Using Python, we can start a terraforming process to 
remake a Minecraft world to your specifications. Even on 
a Pi 3, this will not be a quick process: depending on how 
complex your landscape is, and how much you want to 
transform, it may take several days. So we’1l monitor our 
progress by uploading data to an Initial State dashboard 
so that we can keep track of things remotely. If you just 
want to do the terraforming, there’s another version 
of the code without the Initial State functionality in the 
same GitHub repository (terraforming_no_is.py). 


Generate your world 

Before you start coding, you need to create your 
Minecraft Pi Edition world and select the block type 
with which you want to fill your world. This can be 


any block of your choice, but it has to be a solid block 
(not ladders or torches). Manipulating the Minecraft 
ecosystem can be tricky. For example, if you try to 
turn water directly to lava, you’! probably end up with 
lakes of obsidian, so you might need an intermediate 
step: turn all the water to something inert (like wool), 
then transform it to lava. There may also be some 
blocks you want to keep — snow or water, for example. 


Get the code 

Make sure your Pi is up to date and, if you want to 
create a remote monitoring dashboard on Initial State, 
download and install its data streaming library: 


sudo pip3 install ISStreamer psutil 
Then download the is_terraforming.py code 
(magpi.cc/234A3hY). Note that you’ need to change 


some of the values to suit your Minecraft environment 
and to include your Initial State account details. 
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TERRAFORMING MINECRAFT | Tutorial 


qanquage 


>PYTHON 3 


DOWNLOAD: 


eee RAD ( 
SoA Aa! 


, ' - > 
7h, Mit SPL ac it net 
“- hy o* os on : 
’ 7 i. 5) 


DP GPG A] 
pT Hox 
Toh 


_~ 
re hd 


>STEP-03 
Tune the code 
Terraforming can take a long time — we’re talking 
days rather than minutes. However, we can tune our 
code to speed things up. Explore your world and find 
the tallest mountain range and deepest valley. Make 
a note of the height (the third value displayed in the 
top-left corner of the screen). You can then plug 
these values into the code. 

We have set the default terraforming height 
range from -3 to 35 on the y axis, but you can make 
this bigger (this will take longer) or shorter (this 
will take less time), depending on the size of the 
eeological features in your world. 


>STEP-04 

Set the speed for the power of your Pi 

This code should work on any type of Pi, but older, less 
powerful models may struggle if you terraform at full 
speed. If Minecraft can’t keep up with all the changes 
it’s being asked to make to the landscape, it may hang. 
Therefore, it’s a good idea to pause after a certain 
number of blocks, to allow Minecraft to catch up. On 

a Pi3, you can comfortably transform 500+ blocks 
before the need for a pause, but for a Model B you may 
need to deal with 50 blocks at atime. You’ll probably 
want to run a few experiments to find the optimum 
configuration for your setup. 


>STEP-05 

Register for an Initial State account 

Initial State allows you to upload live data and plot 
interesting charts and graphs. A free account lets 
you stream 25,000 events a month and examine the 
last 24 hours’ worth of data in any bucket. Once you 
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have registered for an account, click on the ‘create 
HTTPS bucket’ button (the plus symbol) and give it a 
suitable name. Then check ‘Configure Endpoint Keys’ 
and copy the Bucket Key and Access Key into your 
version of the code. 


>STEP-06 

Start terraforming! 

If you’re using a free account, edit the code and set the 
Free_account variable to True. This will throttle the 
amount of data sent to Initial State and allow you to 


record the whole process without exceeding the data cap. 


Start your code running and check the console for 


any errors. You can fly to the corner of your world and 


should soon be able to see the changes taking place. 


Once the first data reaches Initial State, you can create 


a cool dashboard: use the Tiles interface and play 
around with the different types available. 


iA, magpi.cc/234A3hY 


Above You can 


create some very 
strange-looking 
worlds, like 

this one where 
everything on the 
surface is made 
of glass 


Below Initial 
State has a range 
of graph types 

to make your 
terraforming data 
look informative 
and cool at the 
same time 
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Tutorial 


The egg, a yellow 
LED, falls froma 
random starting 
point at the top 
of the Sense HAT 


= ] 
‘ih = 

‘Te Lt 

n= = 


The positions 
of the LEDs are 
numbered and 
use an x andy 
axis. However, 
this starts from 
the top-left of 
the matrix 


Tilt the Sense HAT 
left or right to 
move the basket 
to where you think eee ge 0 
the egg will land - nie 
can you catch it? = if ue © yy  (¢) Raspberry Pi 2015 


Raspberry Pi £ 
Sense HAT 


oe 


"ACCEL /GYRO/MAG 


DAN ALDRED 


A Raspberry Pi Certified Educator and 
a lead schoolteacher for CAS. He's 
passionate about creating projects and 
uses projects like this to engage the 
students that he teaches. 

tecoed.co.uk / @dan_aldred 
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MAKE A MOTION-CON TROLLED 


EGG DROP GAME 


Can you catch the eggs as they drop from the top of the Sense HAT? 


ome of the most basic and repetitive games 

can be the most fun. Consider Flappy Bird, 

noughts and crosses, or even catch. With 
this in mind, a simple drop-and-catch game makes 
excellent use of the Sense HAT. Code a yellow LED to 
drop each second, and a basket on the bottom row of 
LEDs. Use code to record the accelerometer reading 
and utilise this so that when you tilt your Sense HAT 
left or right, you can move the basket to catch the 
egg. Catch it and you play again, but if you miss one, 
then it breaks and it’s game over. 


> Raspberry Pi 
Sense HAT 
magpli.cc/ 
1TGGUt5 


Getting set up 

Ensuring that your Raspberry Pi is turned off, attach 
your Sense HAT to the GPIO pins. Use the supports 
and screws to secure the HAT into position. Plug in 
the power and boot up your Pi. The Sense HAT Python 
library is included with the current OS image and 
requires no installation. Either load your preferred 
Python editor and type up the code, or download it to 
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your Raspberry Pi, saving it into your home folder. 

To run the code, press F5; after a short introduction 
screen and a countdown, the game will begin. If you 
open the code ina text editor, you can customise some 
features of the program such as the messages, the 
colours used, and the splash screen. 

To edit or use your own message, find the code line 
which begins sense. show_message — for example, 
on line 32. Change the text within the speech marks 
and add your own message. Editing the colour of the 
message is possible and achieved by changing the red, 
ereen, and blue (RGB) values. The maximum value for 
each is 255, which is the full amount of colour. These 
can be combined to create a wide range of colours. 

For example, the colour blue is [@, @, 255]. 

Like the text, you can also change the colour of the 
ege or basket by editing the RGB values within the 
square brackets. These are set using the code 
sense.set_pixel, found on line 46. You could change 
the values to[@, 255, 0] tocreate a pea drop game! 
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EGG DROPGAME | Tutorial 


Editing and using images a / te = ) qanguage 
When the game begins, an image of a chicken is Bp {, Te ig >PYTHON 
displayed. This is loaded from a file called chick. png, | wi: 
which is stored in the same folder as your egg drop 
program file. You can create your own images to 
display throughout the game and use the code 
sense.load_image("chick.png") on line 34, 
replacing the file name ‘chick. png’ with the 
name of your file. An effective tool to create an 
image is RPi 8x8 Grid Draw, a superb on-screen 
program that enables you to manipulate the 
LEDs in real time. You can change the colours, 
rotate them, and then export the image as code 
or as an 8x8 PNG file. First, we need to install the 
‘Python PNG library’ - open a terminal window and 
type: sudo pip3 install pypng. After this has 
finished installing, type: 


DOWNLOAD: 
magpi.cc/1teCX7Y 


To simulate the egg 
git clone https://github.com/jrobinson-uk/ = dropping, the first LED is set 


RPi_8x8GridDraw in position and coloured yellow (line 46). 
The egg_x is the value the LED’s horizontal position 
; ; — Above Once the 
Once the installation has completed, move to its at the top of the matrix, remember, this is selected egg is on the 
folder by typing cd RPi_8x8GridDraw, then type at random at the start of each drop. The egg_y value bottom line of 
python3 sense_grid.py to run the application. refers to the LED’s vertical position. The LED is then even Sy sett 
The Grid Editor enables you to select from a range coloured black, giving the impression that it’s no longer _ the position of 
of colours displayed down the right-hand side of there (line 63). The egg_y value is increased by one, wens 
the window. Simply choose a colour, then click the which moves to the LED down one place (line 64). Then 
location of the LED on the grid and select ‘Play on that LED is coloured yellow, giving the appearance that 
LEDs’ to display the colour on the Sense HAT LED the egg has dropped down one space (line 65). 
matrix. Clear the LEDs using the ‘Clear Grid’ button The basket is set by turning on one LED (line 47); 
then start over. Finally, when exporting the image, this creates a nice brownish colour. Since the basket 
you can either save as a PNG file or you can export doesn’t move up, the y value position is set to 7. The 
the layout as code and import that into your program. orientation of the Sense HAT is taken using pitch = 
Remember that the image size is limited to 8x8 sense.get_orientation()[ 'pitch'] on line 55. This 
pixels. If you’re looking for inspiration, check out value is fed into a function called basket_move (line 
Johan Viet who has some excellent examples of 18), which calculates the new position of the LED in 
8x8-pixel art (magpi.cc/1SrqGDm). relation to the amount of tilt. Again, the LED is set to 
black so it appears that the basket has left its current Below To make 
Dropping the egg position (line 62). Lastly, the new position is set using fee 
Both the basket and egg mechanics are similar, except sense.set_pixel(basket_x, 7, [139, 69, 19]), egg is dropped 
that the basket only moves left and right along the x where basket_x is the new value of the position of ee ne 
axis. This means that the y axis value stays static. the LED along the bottom of the matrix. a new egg falls 


ge(}" for more informstions. 
ce occ coerce eee eee se sese=s RPATAR] =822se2<eeee esses; 
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Single Frame 


Figure out the positions of the LEDs 9 =~ "Play on LEDs. } 
using the graphical interface } — 
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Tutorial 


))) Sonic Pi 


Raspberry Pi 
aUlalaliave Bacciele)icla 


Sonic Pi v2.7+ 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 
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PROBABILISTIC 
SEQUENCER 


After a brief break while touring, Sam Aaron is back to continue 


his amazing Sonic Pi series 


n a previous episode of this Sonic Pi series, 
we explored the power of randomisation to 
introduce variety, surprise, and change into 
our live-coded tracks and performances. For example, 
we randomly picked notes from a scale to create 
never-ending melodies. Today we’re going to learn a 
new technique which uses randomisation for rhythm 
— probabilistic beats! 


Probability 


Before we can start making new beats and synth 
rhythms, we need to take a quick dive into the basics of 
probability. This might sound daunting, but really it’s 
just as simple as rolling a dice! When you take a regular 
six-sided board game dice and roll it, what’s actually 
happening? Well, firstly you’1l roll a1, 2, 3, 4,5 or 6, with 
exactly the same chance of getting any of the numbers. 
In fact, given that it’s a six-sided dice, on average (if 
you roll lots and lots of times) you’1] throw a1 every six 
throws. This means you have a1 in 6 chance of throwing 
a1. We can emulate dice rolls in Sonic Pi with the dice 
function. Let’s roll one eight times: 


8.times do 


puts dice 
Sleep 1 
end 


Notice how the log prints values between 1 and 6, 
just as if we’d rolled a real dice ourselves. 


Random beats 
Now imagine you had a drum and before you hit it you 
rolled the dice — if you got a1, you hit the drum (otherwise 


you didn’t). You now have a probabilistic drum machine 
working with a probability of 1/6! Let’s hear it: 


live_loop :random_beat do 


sample :drum_snare_hard if dice == 1 
Sleep 0.125 
end 


Let’s quickly go over each line to make sure 
everything is clear. First, we create anew live_loop 
called :random_beat, which will continually repeat the 
two lines between do and end. The first of these lines is 
a call to sample, which will play a pre-recorded sound 
(the :drum_snare_hard sound in this case). However, 
this line has a special conditional if ending. This means 
that the line will only be executed if the statement on 
the right-hand side of the if is true. The statement 
in this case is dice == 1. This calls our dice function 
which, as we have seen, returns a value between 1 and 
6. We then use the equality operator == to check to see 
if this value is 1. If it is 1, then the statement resolves to 
true and our snare drum sounds; if it isn’t 1, then the 
statement resolves to false and the snare is skipped. 
The second line simply waits for @.125 seconds before 
rolling the dice again. 


Changing probabilities 

Those of you who have played role-playing games will be 
familiar with lots of strangely shaped dice with different 
ranges. For example, there is the tetrahedron dice which 
has four sides, and even a 20-sided dice in the shape of 

a icosahedron. The number of sides on the dice changes 
the chance, or probability, of rolling a1. The fewer sides, 
the more likely you are to roll a1; the more sides, the less 
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likely. For example, with a four-sided dice, there’s a1 in 

4 chance of rolling a1; with a 20-sided dice, there’s a1 in 
20 chance. Luckily, Sonic Pi has the handy one_in fn for 
describing exactly this. Let’s play: 


live_loop :different_probabilities do 
sample :drum_snare_hard if one_in(6) 
sleep 0.125 

end 


Start the live loop above and you’!l hear the familiar 
random rhythm. However, don’t stop the code running. 
Instead, change the 6 to a different value such as 2 or 
2@ and press the Run button again. Notice that lower 
numbers mean the snare drum sounds more frequently, 
while higher numbers mean the snare triggers fewer 
times. You’re making music with probabilities! 


Combining probabilities 

Things get really exciting when you combine multiple 
samples being triggered with different probabilities. 
For example: 


live_loop :multi_beat do 
sample :elec_hi_snare if one_in(6) 
sample :drum_cymbal_closed if one_in(2) 
sample :drum_cymbal_pedal if one_in(3) 
sample :bd_haus if one_in(4) 
Sleep 0.125 

end 


Again, run the code above and then start changing 
the probabilities to modify the rhythm. Also, try 
changing the samples to create an entirely new feel. 
For example, try changing :drum_cymbal_closed 
to :bass_hit_c for extra bass! 


Repeatable rhythms 

Next, we can use our old friend use_random_seed 

to reset the random stream after eight iterations to 
create a regular beat. Type the following code to hear 
a much more regular and repeating rhythm. Once you 


raspberrypi.org/magpi 


PROBABLISTIC SEQUENCER 


hear the beat, try changing the seed value from 10@@ to 
another number. Notice how different numbers generate 
different beats. 


live_loop :multi_beat do 
use _random_seed 1000 
8.times do 
sample :elec_hi_snare if one_in(6) 
sample :drum_cymbal_ closed if one_in(2) 
sample :drum_cymbal_ pedal if one_in(3) 
sample :bd_haus if one_in(4) 
Sleep 0.125 
end 
end 


One thing I tend to do with this kind of structure is 
to remember which seeds sound good and make a note 
of them. That way I can easily recreate my rhythms in 
future practice sessions or performances. 


Bringing it all together 

Finally, we can throw in some random bass to give it 
some nice melodic content. Notice that we can also 
use our newly discovered probabilistic sequencing 
method on synths as well as samples. Don’t leave it at 
that, though — tweak the numbers and make your own 
track with the power of probabilities! 


live_loop :multi_beat do 
use _random_seed 2000 
8.times do 
c = rrand(70, 130) 
hi = 


sample :elec_hi_snare if one_in(6) 


sample :drum_cymbal_closed if one_in(2) 


sample :drum_cymbal_pedal if one_in(3) 
sample :bd_haus, amp: 1.5 if one_in(4) 
Sleep 0.125 
end 
end 


Tutorial 


(scale :e1, :minor_pentatonic).take(3).choose 
synth :tb303, note: n, release: @.1, cutoff: c if rand < @.9 
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Image by Chris Yarzab. magpi.cc/28IxWwp (CC BY 2.0) 
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RFID cards define 
head, body, and feet 


Acard reader is 


positioned under 


each sticker 


3x RFID-RC522 
Mifare card 
readers 


10x Mifare cards 


74HC4051 
analogue switch 


16-pin DIL 
sockets 


24-hole by 11- 
hole stripboard 


3x 8-way right- 
angled pin 
headers 


26-way GPIO 
header socket 


> Assorted 
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resistors, 
capacitors, 
and wires 
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Make a Crazy Robot mash-up, with RFID cards 


here’s an increasing number of ‘mixed-up’ or 

‘mash-up’ books, where a third of each page 

can be turned separately to reveal some crazy 
combination of drawings, like people with different 
clothes, dinosaurs or, as we have here, robots. The idea 
is that each complete robot is printed on an RFID card, 
but only a third of it is displayed, depending on what 
reader the card is placed on. This has always been a 
sure-fire hit whenever we have presented it at shows. 
Here is a low-cost Pi version; you can use the supplied 
artwork, or make a class project where everyone draws 
their own figure and they can all be combined. You can 
also add any number of background cards; one Mifare 
card can trigger one of three backgrounds, depending on 
the reader it’s placed on. 


The hardware 

The low-cost RFID-RC522 reader is now widely 
available; we got three for less than £10 from one 
eBay supplier. While the chip itself is capable of 
interfacing in many ways, these inexpensive boards 
are configured such that you can only use an SPI 
interface. This is a little tricky for the Pi, as it only 

has two SPI Chip Enable pins. However, with the 
addition of an analogue switch, we can handle up to 
16 readers easily; for this project we only need three. 
The schematic is quite straightforward and is shown 
in Fig 1 (overleaf). All the RFID readers have their pins 
connected up, with the exception of the ‘chip select 
pin’, which is bizarrely labelled SDA. Full construction 
details are shown in the step-by-step boxes. 
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Gathering resources 

The first thing you need is the artwork for the cards. 
This can be drawn as a class project, copied from a 
book or the internet, or you can use our artwork. We 
say ours, but we commissioned the robot drawings 
from an artist friend, Adam Farra; you can see them 
all in Fig 2 (page 57) and download them from the 
GitHub repository for the project. If you’re drawing 
your own artwork, it should end up as a PNG image 
406 pixels wide by 615 pixels high. It’s important that 
the height is divisible by three. They should also have 
a transparent background, so we can add our own 

in with other cards. There can be three background 
images for each background card. 

You will also need to install an RFID library; we 
used the one at magpi.cc/28LleQN. The sample code 
is useful for testing your readers individually. When 
you’re ready, move the MFRC522.pyc file into the 
folder that contains the m1xUp.py code listing; this 
folder should also contain a directory called Cards, 
which contains the artwork files. 


The software 

The software runs under the Pygame framework 

and starts off by initialising that system. Each card 
causes its associated picture to be drawn, but through 
a different mask depending on the reader the card 
was seen on. In this way, only the head, body, or feet 
are drawn, depending on the reader used. The line 
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mixUp.py 


MIXED UP 


#!/usr/bin/env python 
# All Mixed Up by Mike Cook June 2016 


DOWNLOAD: 


>PYTHON 2.7 


magpi.cc/1NqJjmV 


import RPi.GPIO as GPIO 
import MFRC522 
import time, pygame, os, sys 


PROJECT 
VIDEOS 


Check out Mike's 


pygame.init() # initialise graphics interface 


Bakery videos at: 


magpi.cc/1NqJnTz 


os.environ[ 'SDL_VIDEO_WINDOW_POS'] = ‘center' 
pygame.display.set_caption("All Mixed Up") 
pygame.event.set_allowed(None) 
pygame.event.set_allowed([pygame.KEYDOWN, pygame.QUIT | ) 


screenWidth = 406 
screenHeight = 615 


screen = pygame.display.set_mode([screenWidth, screenHeight ], 2, 32) 


numberOfCards = 10 # picture cards 
numberOfBacks = 3. # background cards 


card = [ pygame.image.load("Cards/R"+str(cardNumber)+" .ong").convert_alpha() 


for cardNumber in range(@,numberOfCards+1) | 
# three background images for each card 


backImage = [ pygame.image.load("Cards/B"+str(backNumber)+" . jpg") 


for backNumber in range(@,numberOfBacks*3) ] 


# number of entries to match numberOfCards variable + 1 


tokens = [ 
@,@x96e2acd5, 0xaa01a910, 0xbd51192b,O@xccb419de, Oxec9f19de, 
@x5c6ccadd, Ox1c@2@1de, Oxcc0101de,@x1ic88fadd, Oxccbal9de | 
# number of entries to match numberOfBacks variable 
backToken = [@x9c3131de, @xbcc8eedd, Oxdc54e6édd | 


headRect = pygame.Rect(@,0,screenWidth, 164) 
bodyRect = pygame.Rect(@,165,screenWidth, 224) 
feetRect = pygame.Rect(0, 384, screenWidth, 231) 
headReader = 0; bodyReader = 1; feetReader = 2 


GPIO.setmode(GPIO.BOARD) 
GPIO.setwarnings(False) 

muxPins = [16,18,7] 

cardPresent = [False,False, False] 
cardID = [0,0,9| 

needRedraw = True 

background = @ 


def main(): 
print "All mixed up" 
ite) 
while 1: 
checkForEvent() 
if needRedraw : 
drawScreen() 
scanReaders() 


def scanReaders(): 
global cardPresent, cardID, needRedraw, background 


>> 
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_ BUILDING THE CARD READER SYSTEM 
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Raspberry Pi 
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>STEP-01 


Make the reader select circuit 

Build the reader select circuit on a piece of 24-hole 

by 11-hole stripboard. Make sure you break the tracks 
underneath the 74HC4051 IC, as well as those shown as 
breaks seen through the board; we always use a socket 
for ICs. Add the right-angled pin headers and solder the 
components in place. Next, wire the links across the board. 
Finally, wire up a length of 10-way ribbon cable for the 
signals back to the Pi. Wire up the other end of the ribbon 
cable to a connector that fits on the Pi's GPIO plug. 


Fig 1 The schematic 
of the project 
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>STEP-02 for reader in range(@,3): 
Attaching the readers setMux(reader) 

First, solder the right-angled pin headers on the (status, TagType) = mfRaeder[reader].MFRC522_Request(mfRaeder| reader |] .PICC_REQIDL) 
reader PCB. Now, make up lengths of 8-way ribbon if status == mfRaeder[reader].MI_OK: 

cable connectors to connect to the reader switch. (status,uid) = mfRaeder[reader].MFRC522 Anticoll() 

Mark each end of the cable with a small white dot 

so you don't get it the wrong way round. At this 
stage, it's worth testing that all three readers work. 


if status == mfRaeder[reader]|.MI_OK and cardPresent[reader] == False : 
cardPresent[reader]| = True 
needRedraw = True 
token = (uid[@] << 24) | (uid[1] << 16) | (uid[2] << 8) | uid[3] 
if getImageNumber(token) != 0 : 


As the readers are affected by metal, it’s important 
to use as little metal as possible in constructing 
the box. Also, the readers interfere with each 
other, reducing the range, so mount them at least cardID[ reader] = getImageNumber (token) 
70mm apart. else: 

setBackground(token, reader) 


print "Card reader",reader,hex(token).rstrip("L") 


that sets the tokens list will need changing to else : 
match the cards that you have. Run the code and cardPresent[reader] = False # no card present 
present the cards to any reader to get a printout 
of the card’s ID number. Next, copy and paste def drawScreen(): 
these numbers into the tokens list. Do the same global needRedraw 
for the background cards with the backToken screen.blit(backImage[ background], (2,2) ) 
list. Now run the program again and see what card screen.set_clip(headRect) 
generates what picture, then stick a printout of screen.blit(card[cardID[headReader]],(@,8)) # change @ to 2 for inverse 
that picture on the card. screen.set_clip(bodyRect) 
You can swap the reader associated with the screen.blit(card[cardID[ bodyReader]],(2,2)) 
head and feet by changing the headReader and screen.set_clip(feetRect) 
feetReader variables. This needs to be done to screen.blit(card[cardID[feetReader]],(@,0)) # change 2 to @ for inverse 
make the display match the reader positions of the screen.set_clip(None) 
reader box if you have it the inverse way up. If the pygame.display.update() 
images you have drawn are not quite aligned, we needRedraw = False 
have written a program to nudge them into place, >> 


which you can also find in the GitHub repo. 
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>STEP-03 

Making the box 

We used MDF to make the box lid and base, with 
12mm strip pine for the sides. We made the base 
and top 280mm by 105mm, and used 10mm taped 
hex pillars to screw the base to the top. The sides 
were glued together and glued to the top; small 
blind recess holes were drilled in the top to give 
the glue something extra to grip on. We used the 
foaming Gorilla glue and held it together with 
clamps while it set. To get the spacing pillars to 
match up, clamp the base to the lid and drill through 
both at the same time. Note that the Gorilla glue 
requires damp joints, hence the water spray. 


Taking it further 

One simple, effective change would be to playa 
sound when a card is presented. Also, you could add 
an LED close to each reader that would flash when 

a card was presented. You also might want to adda 
print function so that you can get a hard copy of your 
mash-up. The artwork is a pencil sketch; how about 
using a paint program to colour it? One with a flood- 
fill paint bucket is easy-to-use. Keep to just a few 
matching colours for each robot; this enhances the 
craziness of the mixed up versions. 

However, the great fun comes when you change 
the artwork completely. We did a version using the 
dinosaur images from a printed mix-and-match 
book; it also mixed up the syllables in the names to 
create a new one and the kids loved it. Not only did 
that involve new artwork, though, but also a change 
from portrait to landscape for the screen window. 
Are you up to that challenge? 
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Fig 2 The cast of crazy robots 
~~ def getImageNumber (number ): 


image = 0 
for i in range(@,numberOfCards+1) : 
if tokens[i] == number: 
image = 1 
return image 


def setBackground(token, reader): 
global background 
background = @ 
for i in range(@,numberOfBacks): 
if token == backToken[i]: 
background = reader + (i*3) 


def init(): 
global mfRaeder 
for pin in range (@,3): 

GPIO.setup(muxPins[pin],GPIO.OUT) # mux pin to output 

setMux(@) 
reader1 = MFRC522.MFRC522() 
setMux(1) 
reader2 = MFRC522.MFRC522() 
setMux(2) 
reader3 = MFRC522.MFRC522() 
mfRaeder = [reader1,reader2, reader3 | 


def setMux(n): 
mask = 1; 
for pin in range(@,3): 
if (mask & n) !=@: 
GPIO.output(muxPins[pin], True) 
else : 
GPIO.output(muxPins[pin], False) 
mask = mask << 1 


def terminate(): # close down the program 
print ("Closing down") 
GPIO.cleanup() 
pygame.quit() # close pygame 
os. _exit(1) 


def checkForEvent(): # see if we need to quit 
global nextF, background, needRedraw, cardID 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 
terminate() 
if event.key == pygame.K_SPACE : # reset display 
background = @ 
needRedraw = True 
for i in range(Q,3): 
cardID[i] = @ 


# Main program logic: 


if _name__ == '_ main_': 


main() 
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MAKE A 
PROTOTYPE 


>7 LCD screen 
and HDMI driver 
board (eBay) 


> Picade PCB 
(pimoroni.com) 


> Zippy ball top 
arcade stick 
(eBay) 


> 2.8mm & 4.8mm 
Arcade daisy 
chain wires 
(eBay) 


> Female A panel 
mount USB 
socket (eBay) 


> 8x 30mm 
Arcade buttons 
(modmypi.com) 


> 2x 3-inch, 4-ohm, 
3W speakers 
(modmypi.com) 


> Various 12.7mm 
stand-offs 
(modmypi.com) 
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Ever wanted your own arcade machine? In this multi-part series, 


WESLEY ARCHER 


Self-taught Raspberry Pi enthusiast, 
founder of Raspberry Coulis, and guide 
writer for Pi Supply and Cyntech. Enjoys 
trying out new Pi projects and sharing them! 
raspberrycoulis.co.uk 
@RaspberryCoulis 
facebook.com/raspberrycoulis 


Play your favourite video 
games using RetroPie 


Download the files to laser 
cut your very own RaspCade 
cabinet like this one 


we’ re going to show you how to build your own RaspCade from scratch 


he Raspberry Pi is a perfect choice for an 

arcade emulator, given its size, power, cost, 

and flexibility. There are many Pi-powered 
arcades available, some DIY and pre-built or kit- 
based, but in this multi-part special we’ ll be showing 
you how to build your own from scratch! Over the next 
few months, you will learn the basics of laser cutting 
your own cabinet, wiring together arcade controls, 
and setting up RetroPie for your very own home-made 
RaspCade! In this tutorial, we’ll be looking at what 
you'll need to get underway... 


Plan your build 

Before starting to build the RaspCade, we thought 
carefully about what would be needed and how to keep 

it simple. We used an LCD screen that was to hand, 

but any 7-inch screen should fit! The trickiest part was 
designing the cabinet, but this should now be as simple 
as downloading the files and getting them cut by a laser 
cutter. The parts list is not set in stone, but pay attention 
to dimensions, particularly the buttons and panel mount 
parts, as the cabinet is designed for our build in mind. 


raspberrypi.org/magpi 


Tutorial 


BUILD YOUR OWN ARCADE MACHINE 


>STEP-02 

Download the designs 

To save you the hassle of making your own 
cabinet, you can download our designs (as 
a ZIP file) here: magpi.cc/28KVsMn. The 
designs have been optimised for use 
with online laser cutting services, 

such as RazorLAB (Ponoko to our 

US readers), to keep things simple. 
Plastics require special solvents for this 
and can be quite messy, so 3mm MDF is 
recommended when cutting, because it’s cheap 
and easy to glue together once assembled. If you 
want to tweak the designs to your liking, then you’ll 


An essential part! 
Pimoroni's excellent 
Picade PCB (now in 
blue) makes setting 


need Adobe Illustrator (or possibly Inkscape), as they 
are saved as EPS files. 


>STEP-03 

Don’t overcomplicate things 

As this is a DIY build, we highly recommend you keep 
things as simple as possible — at least for your first 
attempt, anyway. Arcade machines nowadays are full 
of flashing lights and enticing sound effects. Whilst 
this would be awesome, replicating this at home 
might be challenging. However, if you’re feeling 
adventurous, then go for it! For example, in our build 
we are going to add NeoPixels driven by an Adafruit 
Trinket, and held by custom 3D printed mounts within 
the clear arcade buttons, but you don’t have to do this 
if you aren’t feeling confident. 


>STEP-04 

Software for the task 

There are many options for emulation software to use 
on the RaspCade, but we’ll be using RetroPie in this 
build and we recommend you do, too. RetroPie is very 
easy to set up and provides a fantastic front-end to 
our RaspCade. It’s always being refined and updated 
by the developer, plus it can play a wide variety of 


games, so it makes an excellent choice for this project. 


You can download the latest version of RetroPie 
here: magpi.cc/25UDXzh. 
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>STEP-05 
A handy guide 
If you’re reading this thinking, “Why are there only 
eight buttons instead of ten°”, or “I want flashing 
lights all over the place!”, then feel free to only use 
this series as a guide. You don’t need to follow it to 
the letter. As mentioned earlier, the cabinet design 

is based on the parts we have available, but if you’re 
feeling creative, feel free to design your own cabinet 
or tweak the one in the design. We would love to see 
what you do with your build and hope you share them! 


>STEP-06 

What's next? 

Now it’s time to get all your parts so that you’re ready 
for the next stage; most, if not all of them, should be 
able to be purchased online. Costs may well vary, but 
you should be able to find everything you need. In the 
next edition, we’ll start building our controls. For this 
you’ ll definitely need the joystick, buttons, the arcade 
wiring harnesses, and the Picade PCB. We’11 cover 

the basics of wiring up all your buttons, including the 
joystick, and how to use them with the Picade PCB 

for a hassle-free installation. 


up the controls 

and sound in our 
RaspCade a whole 
lot easier. 


WANT A KIT 
INSTEAD? 


If a DIY version 
is not for you, 
then why not 


check out 
Pimoroni's 
PiCade 
instead? 
magpi.cc/ 
1U9cMLz 


Below Some of 

the components 
we need in our 
build, including the 
obligatory joystick 
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The LED bar with 

the resistor network 
is connected to the 
GPIO and will display 


your message 


USB 5V voltage 
booster step-up 
module 
magpi.cc/ 
1U5Fzop 


LiPo battery 
charger 
magpli.cc/ 
1U5F46y 


Lithium polymer 
battery - 
1000mAh 
magpli.cc/ 
1U5FkSP 


Nylon stand-offs 
magpi.cc/ 
1W/D2eVf 


Red LED bar 


graph display 
magpli.cc/ 
1WD1tLN 


220Q SIL 
network - 8 
commoned 
resistors 
magpi.cc/ 
1W/D1SxG 


36-way header 
strip 
magpi.cc/ 
1\/D1YFA 


Case fan 


Stripboard 
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Using a spare case 
fan is a quick and 
easy way to get the 
spinning element 


The USB 5V booster 
will power your Pi Zero 
with a LiPo battery 


An old CD has been 


used as a platter on 
the fan, to hold the 
rest of the project 


WRITE TEXT 
N THIN AIR 
WITH A PI ZERO 


Create a persistence of vision illusion, an interesting project that’s fairly 
easy to achieve and from which there is plenty to learn 


n this article, we’re going to show 

you how to build a Raspberry Pi Zero setup 

to display text from a file using an LED bar. 
The fun part is that the Pi and all the rest of the 
hardware are spinning, glued onto a PC fan, to deliver 
a fantastic persistence of vision (POV) effect whilst 
remaining wirelessly connected to your network! 


What is POV? 


You can experience persistence of vision in many 
ways. From something as simple and obvious as a flip 
book or a film, to seeing car wheels spinning in the 
other direction, the principle is very similar. These 

are an illusion: what we perceive as motion is given 

by a series of discrete images shown to us at a specific 
rate. If the number of images per second is too low, we 
perceive them as just pictures; get the right frame rate 
and you see motion. 


Persistence of vision with LEDs has been a thing for 
a while and has been perfected over time to extremely 
sophisticated levels. 

Our example works with eight LEDs arranged in an 
LED bar and installed on a rotating platform. When 
the platform, our CD, starts spinning, an LED which 
is turned on will give the illusion of a bright disc. This 
is very similar to what happens when you Start writing 
your name in the air with a sparkler on bonfire night. 

Imagine that you’re able to control the sparkler 
very precisely, and it can also be switched on and off 
at very precise moments during its motion. In such 
conditions, you could be able to see something that 
would remind you of Morse code. 

In the same way, as the CD rotates, we’ll be controlling 
our LED bar with very precise timings, and these will give 
you the impression of very complicated light patterns 
which we eventually use to display characters. 


raspberrypi.org/magpi 


Building the POV 


The most important part of getting this POV to 
run smoothly is the way you fix the system onto the 


CD. Placing the Pi Zero in the correct place will make it 


so that, when turning, the whole setup will have as 
few vibrations as possible. The rule of thumb we 
followed was to drill two 3mm holes on opposite sides 
of the central hole of the CD, so that they would sit on 
one of the disc’s diameters. The two holes correspond 
to the ones on the Pi Zero’s PCB, which are diagonally 
opposed to each other. 

Fix the Pi with the spacers and install the rest of the 
components as shown in the picture. The LiPo battery 
gets tucked in under the Pi. 

Be creative about how you fix things, and use the 
correct amount of Blu-Tack and cable ties. 

We modified the LiPo battery terminals so that we 
could easily plug it into the charger without needing 
to take anything apart. 

Use a spacer between the fan and the CD to 
keep things away from the fan frame. Lastly, put 
together the LED bar as shown in the picture below, 
following the corresponding colour and GPIO 
pin numbers. 


220 OHM RESISTORS 


CONTAIN THE VIBRATIONS 


Even the cable connected to the LED bar will introduce 
substantial imbalance if not properly anchored. Pull all 


the slack of the cable to the centre of the CD and fix it 
tightly so that it won't move once the disc is spinning. You 
might want to experiment, drilling a few holes to find the 
sweet spot for where to place the LED bar, but after a bit 
of trial and error you should have a stable enough setup. 
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Tutorial 


Tuning the rotation speed 
Getting the timing right works better by trial and error 
than by making very complicated calculations, and 
that’s how we approached the problem. We needed 
to make it so that the frequency at which the PC fan 
is spinning, and the frequency with which we’re 
switching the LEDs on and off, somehow converge 
on a point at which the illusion of floating text is 
convincing. We started by choosing about 5-6V with 
a bench power supply to power our 12V PC fan. That 
meant the fan was turning slower or faster, depending 
on the voltage selection of the power supply. In the 
meantime, we started by blinking one of the LEDs 
with some regular timing and went off to see ifa 
dotted line was appearing instead of the bright disc. 
Changing the timing between flashes helped us tune 
the dotted line so that it looked like a succession of bright 
and dark lines which appeared about the same length. 
Once we got there, it was just a question of putting 
together the right code to show the characters we wanted. 
In your own setup, you will only need to adjust the 
voltage provided to the fan once the script is running, 
until you see something floating in the air. 


Going for a spin 
We provide the demo code PiZeroPOV.py on GitHub 
(magpi.cc/IWD4ADE), which will display the contents 
of pov.txt. The script will check the contents of the 
text file every 10 seconds and display them on the 
POV. As the Pi Zero is connected to your network via 
its wireless adapter, you can change what’s being 
displayed at any time without needing to shut down 
or alter the spinning system in any way. The only 
limitations of this demo script are that it only accepts 
lower-case characters and spaces — anything else 
will break it miserably, but, hey, anybody can easily 
improve it with a bit of time and dedication. 

So, as you log into your rotating Pi Zero, just type: 


sudo python PiZeroPOV/PiZeroPOV.py & 
...and start editing pov.txt by using nano: 
nano PiZeroPOV/pox.txt 


This will get your messages in the air! 


Above Have it write 
anything you want 
in the air — it looks 
better in real Life 
than in photos! 


qanguage 


>PYTHON 


DOWNLOAD: 
magpi.cc/1W/D4ADE 
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Wastebasket 
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fy 
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File Edit 


You use a text editor like Geany 


to enter your C program before 


compiling it 


| Terminal 


Symbo 
Fe Functions 


& main [3] 


Search View 
uo vy & w 


is 
2 


14:40:19: New file “untitled” opened 


“WDhello c- /home/pi - G 


Tools Help 


3 3Se- & | 


Build 


Document Project 


> 


void main (void) 
{ 


printf ("Hello world! \n"); 


NOQUBWNr 2 


k-2.0/gtkre opened{1) 
sgins/ejecter/ejecter.c opened(2) 
k-2.0/gtkre closed 


ugins/ejecter/ejecter.c closed 


oe || 


You use the command Line to 
compile and run C programs 


N INTRODUCTION 1O © 
GETTING sIARTED 


Cis one of the most widely used programming languages - 


WHITESPACE 
DOESN'T 
MATTER! 


Unlike Python, 
whitespace 
has no 
significance 

in C - you can 
put spaces, 
tabs, and new 
lines anywhere 
you like ina 

C program 

to make it 
readable. 


62 


MagPi: July 2016 


learn how to use it to program the Pi! 


he C programming language has been around 
for several decades, and is popular both with 
hobbyists and in industry; it’s been used to 
program everything, from the tiny microcontrollers 
used in watches and toasters up to huge software 
systems. In fact, most of Linux (and Raspbian) is 
written in it. It’s a language which allows you to 
control the finest details of the processor, but is still 
simple to learn and read. This series is an introduction 
to C for absolute beginners; you don’t need anything 
other than a Pi running Raspbian to get started. 


What's so great about C? 
Cis avery powerful language — there’s not much you 
can’t use it for — but it’s fairly simple. The language 
itself only has 20 or so keywords, but there’s a huge 
library of additional functions that you can call in when 
you need them. In this series, we’re going to concentrate 
on learning about the keywords, with a few of the more 
useful library functions thrown in for good measure. 
Many of the languages that you may have seen, 
such as Python, are what are called interpreted 


languages. This means that the code you write is run 
directly: each line of code is read in and interpreted 
as you run it. C is different: it’s a compiled language. 
This means that the code you write, known as the 
source code, is never run directly. The source code 

is passed through a program called a compiler, 
which converts it into a machine-readable version 
called an executable or a binary; you then run the 
resulting executable. 

This may seem complex, but it has a few big 
advantages. First, it means that you don’t need to 
have a copy of C itself on every computer you want to 
run your program on; once compiled, the executable 
is standalone and self-contained. Second, the 
compilation process will find a lot of errors before 
you even run the program (but it won’t usually find 
all of them!). Most importantly, the compilation 
process means that the time-consuming translation 
of human-readable code into machine-readable 
instructions has already happened, which means that 
compiled code generally runs many times faster than 
interpreted code would. 
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Hello world - your first C program 

With all that out of the way - which has hopefully 
made you think that C might be worth learning — let’s 
have a look at the first program everyone writes in 
any language: the one that prints ‘Hello World’ on the 
screen. Incidentally, the tradition of writing a Hello 
World program was first introduced with the original 
documentation describing C itself. Just think: no C, 
no Hello World... 


#include <stdio.h> 


void main (void) 

{ 
/* A print statement */ 
printf ("Hello world!\n"); 


Hopefully not too frightening! Let’s look at it line by line. 
#include <stdio.h> 


This is known as a hash-include. As mentioned 
above, the C language has a large library of functions 
that can be included, and we need to use one of 
them in this program: the formatted print command 
printf. This is part of the standard input-output 
library, or stdio for short. So what this line does is to 
warn the compiler that the program needs the stdio 
library to be included as part of the compile process. 


void main (void) 


C is a function-based language; every program 
is made up of a number of functions. 

Each function takes zero or more arguments, and 
returns a single value. A function definition consists of a 
specification of what the function returns (in this case, 

a ‘void’), a function name (in this case, ‘main’), and a list 
of arguments enclosed in round brackets (again, a ‘void’). 

Every C program has to include a function called 
‘main’; when you run the compiled program, the main 
function is the first thing that executes. 

The word ‘void’ is called a type specifier; a void is 
a special type which means ‘no value required’. We’ 11 
look more at types in the next instalment of this series. 

So this line defines the main function for this 
program; it states that the main function takes 
no arguments, and returns no value. 

The code which makes up the function itself is 
enclosed between the two curly brackets {} that 
follow the function definition. 

First, we have a comment telling us what’s going 
on. Comments in C start with the symbol /*, and end 
with */ - anything between those two symbols is 
ignored by the compiler. 


/* A print statement */ 
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AN INTRODUCTION TO C 


The code itself is just one line: 
printf ("Hello World! \n"); 


This is a call to the printf (‘print formatted’ ) 
function from the stdio library. In this case, it takes 
a Single argument, which is a text string enclosed 
within double-quotes. As mentioned above, function 
arguments are enclosed in round brackets. 

Note that the line ends with a semicolon. All 
statements in C must finish with a semicolon, this 
tells the compiler that this is the end of a statement. 
One of the most common beginner mistakes in C 
is to forget a semicolon somewhere! 

What about the string itself? The ‘Hello World!’ bit is 
straightforward enough, but what about that ‘\n’ at the 
end° Remember this function is called print formatted? 
Well, the \n is a bit of formatting; it’s the symbol for 
a newline character. So this line will print the string 
‘Hello World!’, followed by a new line. 


Compiling your program 

Let’s compile and run this. Raspbian includes a C 
compiler called gcc, so there’s nothing to install; just 
start up Raspbian on your Pi and you’ re ready to go. 
Use your favourite text editor to create a file called 
hello.c, copy the program above into it, and save it. 
Then, from a terminal, go into the directory where you 
saved hello.c and enter: 


gcc -o myprog hello.c 


This calls the gcc C compiler with the option 
-o myprog, which tells it to create an executable 
output file called myprog, and to use hello.c as the 
input source code. 

If you entered your C code correctly (did you make 
sure the semicolon was there?), this should take a 
second or so and then return you to the command line. 
There should now be a file in the current directory 
called myprog — try running it by typing: 


. /myprog 

Et voila! You should now have... 

Hello World! 

...written in the terminal. 

That’s your first C program written, compiled, and 


run. Next time, we’ll start using C for something a bit 
more useful... 


| File Edit Tabs Help 


Tutorial 


CHECK YOUR 
BRACKETS 


Unlike 
whitespace, 
punctuation is 
very important 
in C - make 
sure you don't 
use a curly 
bracket where 
a round one 

is needed, or 
vice versa. 


CHOOSE 
YOUR EDITOR 


You can use 
whatever 
editor you like 
to enter code, 
as long as it 
saves it as 
plain text. The 
Geany editor 
included in 
Raspbian isa 
good choice, 
but you can 
also use 
Leafpad, nano, 
or any others 
that you prefer. 


RUNNING 
YOUR 
PROGRAM 


You need to 
tell Linux that 
the program 
you want 

to run is in 
the current 
directory, so 
don't forget 
the ./ before 
myprog, or it 
won't know 
where to Look! 


Left You interact 
with both the 

C compiler and 
your compiled C 
programs from the 
command Line; you 
can either do this in 
a terminal window 
in the desktop, or 
by booting your 

Pi straight to the 
command Line 
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Tutorial STEP BY STEP 


NeoPixels, linked to GND and 
GPIO 18 (for data), may be hooked up 
using conductive thread 


: Auai3e 


Our DC power should be 
between 5V (minimum) and 9V 
(for brightest, dazzling results) 


wd = | 
> ---> — 
. > » 
+ a i i 


AAA Battery 


Our piezo buzzer, connected 
between GND and GPIO 22, 
gives some fun musical tones 


1 : — Aua38 9 Vw 


oe . @ ee eee eoeeeee3seseee¢?ees & 
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AUN 


MAKE A 
RASPBERRY BERET 


We'll add some wearable electronics to our hat: music, lights, camera, 


64 


A hat - ideally 
a beret 


Piezo buzzer 
magpi.cc/ 
28IjuBH 


WiFi dongle 
magpi.cc/ 
281jAsZ 


Battery packs (5V 


for Pi; 5-9V for 
NeoPixels) 


Camera Module 
magpi.cc/ 28ljlsz 


Pisoundo 
package, 
originally from 
onebeartoe 
magpli.cc/ 
28IjRMy 


Rpi_ws281x 
library from jgarff 
magpi.cc/ 
281jT6X 
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and some 3D prints in a digital homage to Prince 


or some people hearing about the 

Raspberry Pi for the first time, a certain song 
entered their head. This earworm turned out 
to be the eighties classic Raspberry Beret. It’s now 
become more poignant with the untimely departure 
in April 2016 of legendary musician Prince. 

As far back as August 2011 in the forum, there was 
even a merchandising suggestion of a Raspberry (Pi) 
Beret. Since nothing came of it, we’re going to hack our 
hat for some fun — adding colour, sound, and vision. 


>STEP-O1 

Prepping the Pi 

We start out with a fresh installation of Raspbian. Use 
the WiFi dongle to connect to the network. Make sure 
everything is up to date: 


sudo apt-get update && sudo apt-get upgrade 
Take note of the Pi’s IP address: 
hostname -I 


We'll then be able to work remotely via SSH, and 
later point our smartphone or web browser at the Pi. 


You could also find the IP via the graphical interface, 
a smartphone app (such as Fing), Bonjour via Mac, 
via a router admin page, or a tool such as Nmap. 


>STEP-02 

Making the sign (of the times) 

If you have access to a 3D printer, you can creatively 
spruce up the hat with some colourful 3D prints. 
Prince famously became associated with a shape, 
later known as the ‘Love symbol’, even replacing 
his name at one time. We easily found a vector 
eraphic (SVG) online (magpi.cc/281166C), as created 
by onebeartoe. Bringing the file into Tinkercad 
(tinkercad.com), via Import URL, giving it a height 
in the process, allows us to generate a 3D printing 
file. We rescale it so our NeoPixels shine and our 
camera can shoot through it. We must then generate 
our final ‘G-Code’ file to be printed. 


>STEP-03 

What it sounds like when piezos cry 

The piezo is no simple buzzer. Much like phones 
of old, we can program it to play very basic tunes, 
although don’t expect quality — it’s more like a 
novelty musical Christmas tie than high-fidelity. 
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First, check the version of Java (it should be 1.8): 
java -version 

If needed, install/upgrade via: 

sudo apt-get install oracle-java8-jdk 


The latest JAR package of our Raspberry Beret 
version of Pisoundo can be downloaded and copied 
to the Pi from magpi.cc/28IqaUQ. 

If you’ve already hooked up the piezo as in the 
schematic, you can launch the application via : 


sudo java -jar pisoundo-@.@.1-Raspberry- 
Beret.jar 


From the network, we then point a browser at 
http://(IP_address_of_Pi]:2111/ui/index.html 
and choose a tune from the list. Alternatively, it’s 
possible to inject your own musical code by clicking 
on the On-the-Fly link on the page. 


>STEP-04 

Add some lights 

Having hooked up our individual NeoPixels, as per 
the diagram, we need to carry out the following 
commands to get our lights on and flashing. 


sudo apt-get install build-essential 
python-dev git scons swig 

https: //github.com/jgarff/rpi_ws281x.git 
cd python 

sudo python setup.py install 


In the example given, we see three NeoPixels, but 
you can choose to add as few or as many as you want 


(individual, rings, or strands). To configure this, type: 


cd examples/ 
sudo nano strandtest.py 


Then adjust the following line to suit your setup: 
LED_COUNT = 3 # Number of LED pixels 
Finally, to launch our program, use: 

sudo python ./strandtest.py 


Our LEDs should start to flicker, dance, and 
change colour. 


>STEP-05 

Cameras, action... 

A final step is to hook up our Camera Module to take 
photos or even broadcast a live video stream. One of 
the easiest ways is with the RPi Cam Web Interface 
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>PYTHON 


DOWNLOAD: 
magpi.cc/28lqenE 


Left Placing the 
piezo on the top, 
NeoPixels around 
the edge, and 
camera on the 
front, we add our 
3D ‘symbols’ fora 
final Princely touch 


Left Printing off 
3D decorative 
symbols adds 
colour to our 
headwear 

and hides our 
electronic 
connections. 
Hot glue is our 
friend when 
attaching them 


LE BERET 
BASQUE 


The beret is 
often thought 
of as French, 


but for us it’s 
usually more 
associated 
specifically 
with Basque 
regional 
tradition. 


a 


(magpi.cc/28InKFJ). Don’t forget to activate the 
camera via the Configuration menu on the Interfaces 
tab. Here’s a simple installation method: 


git clone https://github.com/ 
silvanmelchior/RPi_Cam_Web_Interface.git 
cd RPi_Cam_Web_Interface 

chmod u+x *.sh 

./install.sh 


Once we’ve set this up, all we need to do is point a 
web browser at the IP address of our Pi to access the 
RPi Cam Control. 


>STEP-06 THE MELON 


ae aia HAT 
Explore the possibilities 
If you tested out this project on a breadboard to get In France, they 
it working, it’s now time to install all the electronics think of the 
insid hat. Use your imagination to modify and Po eave 
insi € Our at. you agina ya being British. A 
make it better. Hack the hat. What else could we add fruit connection 
to our chapeau® — it's called 


a ‘melon hat’ 
in French! 


So now we have a Raspberry Beret — the kind you 
wouldn’t find in a second-hand store. Enjoy! 
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PHIL KING 


When not sub-editing The MagPi and 
writing articles, Phil Loves to work on 

Pi projects, and to help his six-year-old 
son learn Scratch coding. 

@philking68 


By wiring the ‘-" row, or ground 
rail, toa GND pin, multiple 
components can share 

the connection 


The LED's longer leg is wired 
to GPIO 17, while the other 

is connected via a resistor 

to the ground rail 


When the button is pressed, 
the circuit is broken and 
Scratch senses a zero 

value from GPIO pin 21 


IGHT AN 


Scratch can be used with the Pi’s GPIO pins for physical computing projects. 


Youll 


> 


> 


> 


> 


> 


> 


Need 


Solderless 
breadboard 


LED 
333 resistor 
Push button 


3x male-to- 
female jumper 
wires 


Here, we’ll hook up a button-activated LED 


n the latest version of Raspbian Jessie, Scratch 

features a built-in GPIO server to make it 

easier to control electronic components or 
add-on boards. In this first GPIO tutorial, we’ll be 
creating a simple circuit with a button that, when 
pressed, causes an LED to light up. Take a look at the 
“You’1l Need’ box to see which electronic components 
are required; you can buy them separately, but they’re 
all in the CamJam EduKit #1 (magpi.cc/10cXtim). 


Male-to-male 


jumper wire 
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Connect the LED 

It’s advisable to turn the Pi off when building your 
circuit. The breadboard features numbered columns, 
each comprising five connected holes. Place your 
LED’s legs in adjacent numbered columns, as shown 
in the diagram. Note that the shorter leg of the 

LED is the negative end; in its breadboard column, 
insert one end of the resistor, then place the other 
end in the outer row marked ‘-’ (the ground rail). 
Use a male-to-female jumper wire to connect 
another hole in that ground rail toa GND pin on 

the Pi. Finally, use a jumper wire to connect a hole 
in the column of the LED’s longer (positive) leg 

to GPIO pin 17. 


Configure Scratch GPIO 

Before we can use the GPIO pins from Scratch, we 
need to turn its GPIO server on. While this can be 
done from the Edit menu, instead we’ll get our code to 
activate it. Undera when green flag clicked block, 
add a broadcast Control block, click its arrow, select 
new/edit, and enter gpioserveron. We also need to 
configure GPIO pin 17 as an output pin (to trigger the 
LED), so add another broadcast block and change 

it to configi7out. 


This project is simple to wire up using a 
solderless breadboard and some jumper wires 
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Ver lebles 


Above Ticking the button's gpio21 sensor value will 
show it on the stage, which is handy for testing 


>STEP-03 

Light the LED 

We’ ll now test our circuit by using a loop to make 
the LED blink. Add a forever block to the bottom 
of your code. Within it, add the following blocks: 
broadcast gpioi7on, wait 1 secs, broadcast 
gpio17off, andwait 1 secs. Now try running the 
code (shown in Listing 1): your LED should blink on 
and off repeatedly. 


>STEP-04 

Connect the button 

We can control our LED by adding a push button. 
Again, we’d advise you to turn the Pi off while 
connecting new components. Add the push button to 
the breadboard, with its pins straddling the central 
eroove (as shown in the diagram). Connect a male- 
to-female jumper wire from one pin’s column to GPIO 
pin 21 on the Pi. Connect a male-to-male jumper from 
the other pin (on the same side of the groove) to the 
eround rail you’re using for the LED circuit (to share 
its connection to the GND pin). 


>STEP-05 

Configure button 

Before Scratch can react to your new button, it needs 
to be told which pin is its input. Delete the forever 
loop from your blinking LED code by dragging it out 
of the Scripts area. Add another broadcast block 
with config21in to configure GPIO pin 21 as an input 
(see Listing 2). Run and stop the code. Now, click the 
Sensing category in the top-left pane. Find the sensor 
value block and change it to gpio021. Click its tickbox 
to show its value on the stage: whenever the button is 
pressed, it should change from 1 to O. 


>STEP-06 

Link to LED 

With the button working, it’s time to make it trigger 
the LED. Add the code from Listing 3 to the end of 
your code. Again, we’re using a forever block for 

a continual loop. Inside it we add an if...else block. 
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LIGHT AN LED 


when clicked 


broadcast gpioserveron | 
broadcast configi/out 


forever 
broadcast gpiol7on 
wait §} secs 
broadcast gpiol7off . 


wait §} secs 


when clicked 
broadcast gploserveron 
broadcast configl7out 


broadcast config2lin 


forever 


if gpio2l sensor value = 


broadcast gpiol ott 


else 


: broadcast gpiol7on 


when clicked 
broadcast gpioserveron 
broadcast configl7out 
broadcast config2lin 


forever 


if gpio21_ sensor value = fl 


broadcast gpicl7oft 
else 


broadcast gpicl7on 


=, 


In the if field, we place an = Operator block; in its left 
field, we add gpio21 sensor value, with 1 in the right 
field. Underneath, we insert broadcast gpio17off. 
This way, when the button isn’t pressed, the LED will 
be off. Under else, we insert broadcast gpio17on, 
to light the LED when the button is pressed. Run the 
code (as in Listing 4), press that button, and watch 
your LED! In the next tutorial, we’ll add more LEDs 

to the circuit to make a pedestrian crossing. 
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Pi projects, and to help his six-year-old 
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Each LED is connected to a different 
GPIO pin, so it can be triggered 
during the traffic light sequence 


ground rail and GPIO pin 16 to make 
our pedestrian crossing beep 
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When the button is pressed, the 
circuit is broken and Scratch senses 
a zero value from GPIO pin 21 


A piezo buzzer is wired up to the 
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TRAFFIC LIGHTS 


We use three LEDs and a push button to make a pedestrian crossing 


n the latest version of Raspbian Jessie, Scratch comprising five connected holes. Add the LEDs to it, as 


features a built-in GPIO server to make it shown in the diagram. If you still have the setup from 
easier to control electronic components or the previous tutorial, you can leave those components, 
add-on boards. In this second GPIO tutorial, we’ ll including the red LED, in place. As before, the shorter 
create a pedestrian crossing with some traffic lights (negative) leg of each LED should be connected via a 
> Solderless and a sound alert using LEDs, a push button, anda resistor to the ‘—’ row (common ground rail), which 
eicetetelerelig buzzer. Again, all the components required are in the is wired toa GND pin on the Pi. Each LED’s longer 
> 3x LEDs: red, CamJam EduKit #1 (magpi.cc/10cXtim). (positive) leg should be connected to the respective 


yellow, and 
green 


eke § Connect the LEDs 

> Push button It’s best to turn the Pi off when building your circuit. Configure Scratch GPIO 

> Piezo buzzer The breadboard features numbered columns, each First, we need to turn on Scratch’s GPIO server. Under 
awhen green flag clicked block, add a broadcast 
Control block, click its arrow, select new/edit, and 
enter gpioserveron. We also need to configure 

our LEDs’ GPIO pins as outputs, so add three more 
broadcast blocks and change them to config17out, 
config23o0ut, and config25out respectively. While 
we’ re at it, we’ll configure the pins for the buzzer 
(config16out) and button (config21in) we’ll use later. 
Your code should look like Listing 1. 


GPIO pin via a male-to-female jumper cable. 


> 5x male-to- 
female jumper 
wires 


> 2x male-to-male 
jumper wires 


Traffic light sequence 

We’ll now test our circuit by creating a traffic light 
sequence: red, red/amber, green, amber. Add the 

code from Listing 2. Here, within a forever block, 

are blocks to turn the LEDs on and off in the correct 
sequence, waiting a few seconds between each change. 
Try running it to check that all the LEDs are connected 
correctly and working. 


While there's 

quite a jumble of 
wires, it's relatively 
easy to connect all 
the components 
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Above Four pieces of code are used: for GPIO configuration, 
light sequence, button press detection, and buzzer beeping 


>STEP-04 

Connect the button 

For our pedestrian crossing, we’ll need a push button. 
Again, you can use the one already placed in the previous 
tutorial, which straddles the central groove of the 
breadboard and is connected to the ground rail and GPIO 
pin 21. We’ve already configured it as an output in step 
2; run and stop that code. Now, click Sensing in the top- 
left pane. Find the sensor value block and change it to 
gpio21. Click its tickbox to show its value on the stage: 
when the button is pressed, it’1l change from 1 to O. 


>STEP-05 

Stop the lights 

We need to get a button press to cause the traffic 
lights to stay on red for a few seconds. Select Variables 
from the top-left, then click ‘Make a variable’ and 
enter ‘pushed’ in the text field. Add the code from 
Listing 3, keeping it separate from the rest. Using an 
if block, this sets pushed to True when the value 
sensed from GPIO pin 21 is zero, i.e. when the push 
button is pressed. 

Next, we need to add an if...else block to our traffic 
light sequence code, to stop it when pushed is True. 
After moving the light sequence blocks out of the 
forever block (keeping them in the Scripts area), add 
in an if...else block and put the light sequence blocks 
back under if. In the if field, use an = Operator 
block with pushed in the left field and ‘False’ in the 
right. Under else, add a broadcast and wait block 
set to ‘beep’; we’ll be using this for our buzzer in 
the next step. Your light sequence code should now 
resemble Listing 4. 


>STEP-06 

Add a buzzer 

Finally, we’ll add a piezo buzzer, connected to the 
eround rail (short leg) and GPIO pin 16 (long leg), 

to make a beeping noise when it’s safe to cross the 
road. Add the code from Listing 5 separately. This 
runs whenever beep is broadcast, after the button is 
pressed and the light sequence ends. It shows a red 
light and uses a repeat loop to turn the buzzer on and 
off for a beeping sound. Finally, it turns off the red 
LED and resets the pushed variable to False. Test out 
your pedestrian crossing by pressing the button! 
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when clicked 


when clicked 
forever 


broadcast gpiol/on — 


broadcast gpioserveron 


broadcast configi7out 
wait S| Secs 


broadcast gpio2son | 


broadcast  config23out | 
broadcast 


config2S5out 
wait - SECS 
broadcast 
broadcast gpiol/7off 
broadcast 
broadcast 9pio23off 


broadcast gpio25on 


when clicked wait S| SECS 


set pushed broadcast 9gpio25off 


forever 


broadcast 9pi023o0n 


if opio21 |sensor value = fi) 


ito ii 


wait ie secs 


set pushed broadcast 9pio23off 


when clicked 


forever 


if pushed = [F/E4 


broadcast gpiol/on 
wait gg secs 
broadcast gpio230n 
wait tee secs 
broadcast gpiol/off | 
broadcast gpio23off 
broadcast gpio25on 
wait Gg secs 
broadcast gpio25off 
broadcast gpio23on 
wait 2] secs 
broadcast gpio23off 
else ; 


broadcast beep | and wait 


when I receive beep | 
broadcast gpiol/on 
repeat 
broadcast gpiol6on 
wait (WD secs 
broadcast gpiol6off 


wait 0.5 | secs 


broadcast gpio 1Joft E 


[ollrelse 


set pushed 


July 2016 MagPi | 69 


YOUR QUESTIONS ANSWERED 
NEED A 
PROBLEM 


FREQUENTLY geet 
A S K E D OQ U E S a} | OC N S tment: 


to feature in a future issue. 


Your technical hardware and software problems solved... 4A 


Grab the code 

All the code for Astro Pi is open-source and 

available to download from the Astro Pi GitHub 
(github.com/astro-pi). With the case and buttons, you 


can run the games and some of the experiments that 


HOW CANIMAKEANASTROPIZ require the sensors, but you’!] have to run them manually. 
Camera experiments 


Print a case Some of the experiments require the Raspberry Pi 

You can 3D print a replica of the Astro Pi flight unit camera, mainly the standard camera such as in Crew 
currently in use on the International Space Station. Detector; however, EnviroPi needs an IR camera (Pi 

It fits a Raspberry Pi with a Sense HAT and can be NoIR) and a blue filter to run properly. You may need 
found on the Astro Pi site: magpi.cc/28KOC8h to take photos from a plane, though! 

Add some buttons Master control program 

The Astro Pi case has specific buttons on the ISS On the ISS, astronauts such as Tim Peake selected the 
that you can also buy down on Earth. These need programs using the joystick and buttons, thanks toa 
to be wired up to the Raspberry Pi, and there’s special selector program. The code for it isn’t available 
a learning resource on where to get the buttons yet, but you can always program your own in Python. 


and how to connect them: magpi.cc/28KfzFn 


Alternative buttons 
The buttons used on the flight cases aren’t the only 
Below Abeautiful ones you can use (they can be a little expensive) Get the MP3 players 
see ibe — any tactile push buttons can be used, although The 2016 competition called for MP3 players, and these are 
sanshardware you may need to file the case down for it to fit. available on the Astro Pi GitHub (github.com/astro-pi) 
as well. You’ll need to plug in speakers or headphones 


to listen to anything on them, though. 


Space tunes 

Several pieces of music were composed and sent 
up to Tim to listen to on the Astro Pi. You can 
find these on the Raspberry Pi SoundCloud page 
(soundcloud.com/raspberry_pi). Take a listen 
and maybe you’ find a new favourite track. 


Programme your own music 

The music for these challenges was created on Sonic Pi 
(sonic-pi.net). We’ve had many tutorials about Sonic 
Pi in the magazine (including this issue). Indeed, we 
also have a book filled with Sonic Pi tutorials, which 
can be found here: magpi.cc/MagPiStore 
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What SoC does the Raspberry Pi use? What is an SoC? 


All versions and revisions of the Raspberry Pi, other A System on a Chip (SoC) is a method of placing all necessary 
than the Raspberry Pi 2B/3B, use the Broadcom electronics for running a computer on a single chip. Instead 
BCM2835. This contains an ARM1176JZFS with floating of having an individual chip for the CPU, GPU, USB controller, 
point, running at 7OOMHz, and a VideoCore IV GPU. RAM, northbridge, southbridge, and so on, everything is 

The GPU is capable of Blu-ray-quality playback, compressed down into one tidy package. 


using H.264 at 40Mbps. It has a fast 3D core, accessed 
using the supplied OpenGL ES2.0 and OpenvVG libraries. How does the Raspberry Pi boot? 


The Model 2B uses the Broadcom BCM2836. This All the files necessary for booting are installed in a FAT32 

contains a quad-core ARM Cortex-A7 processor with partition of the SD card. The Raspberry Pi has to have an SD 

floating point and NEON, running at QOOMH7z, and the card installed to boot from, but a USB HD can ‘take over’ 

same VideoCore IV GPU that's in the other models after the initial boot. You cannot boot without an SD card. 

of Raspberry Pi. The Model 3B uses the Broadcom 

BCM2837, containing a quad-core ARM Cortex-A53 Do you sell a self-assembly kit? 

running at 1.2GHz. Its GPU capabilities are equivalent No. It would be too expensive for us to provide kits alongside 

to the Pi 2. finished boards, which would mean introducing another step 
in manufacturing. A kit would also be impossible to hand- 

Why was the ARM1176JZFS selected? solder. We use special equipment (robots!) to solder on the 

Cost and performance factors. BGA package and other tiny components. 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered: 
oe 


How do | find The MagPi on Google Play 

or the App Store? 

All you have to do is go to the search bar and type ‘The MagPi 
or ‘Raspberry Pi' to find us. 


I've subscribed to the digital edition and | can't sign 

in to restore my purchases. Please help! 

Since your The MagPi purchases are linked to your Google or Apple 
accounts, there's no need to sign in at all. If you'd like to re-download 
your purchases on your current device, or make your purchases 
available on other devices, all you need to do is press ‘Subscribe’ 


on the home screen, then ‘Restore Purchases’ on the next screen. ane 


>» Google Play 


How can | search the digital magazine for keywords? 
Finding direct references is really easy with The MagPi app: all you 


have to do is tap the screen to get the app's GUI to show, and then 4 Available on the 


press the small magnifying glass icon in the top-right corner of the & A p p Sto re 
screen. Just type in your search term to find the relevant results. 
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PET TECH 
PROJECIS 


Create something for your critter with these amazing Raspberry Pi projects for pets 


e love to see cool projects that combine 
technology and cute critters here at Raspberry 
Pi Towers. After all, pets are family, and 

we love Raspberry Pi projects designed around our 
four-legged (or more) friends. 

There have been some great examples over the 
last few months, so we thought it’d be a great idea to 
herd them all into one giant feature to show you our 
favourite pet-themed projects. 

Raspberry Pi builders are a quirky bunch, and we’ve 
got pet projects for all kinds of pets. Cat owners will 
love Jasper’s Cat Exercise Wheel, David Bryan’s Pi- 
Powered Cat Feeder, and John Shovic’s MouseAir. 
Dogs will go all waggy-tailed for Matt Reed’s Sniffur or 
David Hunt’s Pi-Rex. 

Some of the best projects here put animals on social 
media: Kate Bevan’s Tweeting Cat Flap and Henry 
Conklin’s Twitter for Dogs both allow pets to interact 
online (by moving or barking). 

We’ ve also included a cool project for smaller 
creatures. Will McGugan’s Beetlecam monitors the 
nocturnal movements of elephant beetles. 

There ale some Super prejccis ere so pulsomec 
food in your pet’s bowl and settle down to figure out 
what to make. 
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When it sees a cat, it flings a toy mouse! That’s the basic premise 
behind this brilliant cat-detecting mouse launcher 


ats love chasing mice, which is why so many 
cat owners wake up with unwanted presents 
Ci tictedeons tens: 

If your cat is a hunter, then check out John Shovic’s 
brilliant MouseAir project (magpi.cc/22MIwgq3). This 
Raspberry Pi build keeps a cat’s urge to chase after 
mice in check by flinging toy mice for it. “The goal of 
the project,” says John, “is to be able to detect a cat 
walking by and fire a mouse. It worked!” 

It may not surprise you to learn that the idea was 
conceived in a bar. The MouseAir was dreamt up in 
the Fedora in Coeur d’Alene, Idaho. “It was named by 
Sarah, the most excellent bartender there, and some 
Blue Moon beer,” John discloses. 

MouseAir combines a Pi Camera Module with a 
Mouse Loading System and Mouse Launching System 
(which flings toy mice into the air). “The Mouse 
Loading System is a conveyor belt, driven by servo 


motors, that drops the mice into the Mouse Launching 


System,” explains John. 


The Mouse Launching System is two rapidly spinning 


DC motors. These fling the mouse for the cat to chase. 
“We’re using a Pi Camera on a pan-and-tilt 
StU TOcap line fie calevients examine tine 


launching mechanism for jams, motion detection, and 


stream video,” says John. “The conveyor belt is the 
last thing that needs a little work. 


“T had so much response to the project (including the 


response from my cat) that I decided to do a redesign 
of MouseAir, incorporating what I had learned from 
the project. | aggressively redesigned to eliminate 
unneeded hardware, and drive down the cost and size.” 
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JOHN SHOVIC 


Dr John C Shovic is the chief technical 
officer and co-founder of SwitchDoc 
Labs. He has also served as a Professor 
of Computer Science at Eastern 
Washington University, Washington State 
University, and the University of Idaho. 


Left There have been two versions of the 
MouseAir. The second edition uses the 
Raspberry Pi Camera to detect nearby cats 


MOUSEAIR fi 


> Pi Camera Module 


> Servo motors 


> DC motors 


The toy mouse is The Pi Camera is used to detect 
flung inthe direction |. the movement of the cat, and 
of the cat by the to check for mice jams 

Mouse Launching 

System (two 

spinning DC motors) 


The Mouse 
Loading 
System is 

a chute 
that stacks 
up mice. A 
servo motor 
is used to 
move the 
mouse onto 
the launch 
system 


Left The MouseAir's 
3D printed case 
houses the 
Raspberry Pi and 
servo motor 
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Feature 


TOP TEN 


Wuf! Bark! Grrrr... this Raspberry Pi takes 
a dog’s barking and tweets it online 


Below Machine 
learning is used to 
detect which noises 
belong to Oliver 


Henry Conklin’s dog, Oliver, can share his barks 
using Twitter thanks to the Bark Detect project 
(magpi.cc/28KCBxd). “My dog Oliver has always 
been quite vocal,” explains Henry, “and recently | 
decided that his thoughts and comments needed to 
be shared with the world. Thus, the @OliverBarkBark 
project was born.” 

By connecting a Raspberry Pi, WiFi dongle, and 
microphone, Henry was able to make a system that 
“automatically detected, filtered, and published each 
and every one of Oliver’s deafening vocalisations.” 

The Bark Detect is much more advanced than it 
appears. “I took a machine learning approach to filter 
out the barks,” reveals Henry. “I built a model using 
pyAudioAnalysis (magpi.cc/1VKsITG) and a day’s 
worth of barks. I then set up a Bash script to run every 
ten minutes and classify each recorded sound.” 
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-_ —y — at 


When Oliver bar 
by Bark Detect F) 


ks, his speech is pj 
picked 
nd tweeted online at 


The barks are forwarded to the Twitter API using 
python-twitter (magpi.cc/1VKsGet) and posted under 
the handle @OliverBarkBark: be sure to follow! 
Currently, the tweets are random strings composed of 
‘bark’, ‘ruff’, and ‘woof’. “I plan to replace that witha 
bark-to-text translator that will likely produce similar 
results, but be much closer to Oliver’s actual. voice.” 
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wi te aN tae oe ri yy | Ya Every time Daphne heads 
\e Qa YS ae ‘S  ¥eer Pe eas res a through her cat flap, it 
= a pe ( SS ee fer; snaps her picture and 
tweets about it 
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FLAPPY MCFLAPFACE 


Daphne announces her arrival to 
the whole world every time she 
saunters through her cat flap 


| Left A generative 
grammar Python 
program creates 
tweets for the 
Flappy McFlapface 


All cats think they’re special, but only Daphne has her 


very own Twitter-enabled cat flap that heralds her arrival ane Jalianle cece 

online. The Flappy McFlapface project snaps a photo and crores = fon aakss! I's the beyond price ite 

tweets it, along with a cute randomised phrase. | eeu mind is own. a ee 
Built by Bernie Sumption, this cat flap is a thing of tien cal = 


beauty. “Daphne often takes to social media to rant | LA Tweet te rsopy Meraceace | 
about the inadequate service provided by her staff | : 


(tech journalist Kate Bevan),” explains Bernieonhis “ 
blog (magpi.cc/1VKui85). “This activity is cathartic | mecnchen aT 
and highly recommended for any household pet. 
Unfortunately, Daphne’s cat flap was until recently The Raspberry Pi uses a generative grammar 
mute, and couldn’t tell the world about its thoughts program to create a tweet for Daphne. “It works by 
and feelings.” taking a standard sentence structure and replacing 

A £3 reed switch from Maplin provides the input. nodes in the sentence with one of several options,” 
“This is wired to the GPIO sensors, using a couple of says Bernie. Tweets include ‘Most exquisite Daphne, 
resistors that prevent the Pi from being damaged by how soft is your magnificent fwuff. I can expire 
drawing too much current. The reed switch is duct- without regrets,’ and ‘Oh my! It’s Daphne, how noble 
taped to the cat flap so that when Daphne walks is your imperial demeanour. No wall-mounted fixture 
through, the voltage on a GPIO pin changes and the could be luckier than me.’ You can follow Flappy 
software can spring into action.” McFlapface on @DaphneFlap. 
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When a bark is detected, 
the Raspberry Pi gets the 
motor driver circuit to 
drive the actuator 


i 


er 
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DAVID HUNT 


David is a senior embedded Linux 
software engineer. In his spare time, 
he takes pictures and plays with 
gadgets and technology. 


Lee be 
Be Ah i 


P igh % se 


The central door lock 
actuator is used asa 
locking mechanism. This 
pulls the door lock open 
when a bark is detected 


An audio detector circuit kit from Maplin is : 0 RR Re: es ve , ; “ oe The door is connected to a weight via a 
hacked into the Raspberry Pi. This detects ie oR se = ia pulley system. When the actuator is pulled 
Lexi’s barks and sends a signal to a GPIO pin ee Ne I ce ee Rais ae Se’ back, the door automatically swings open 


YOU'LL 
NEED 


> Central door 
lock actuator 


> Angle bracket ; 
Seerenem One dog’s bark is enough to open doors on command 


avid Hunt’s dog Lexi has her very own door. 
The Raspberry Pi inside’ Pi-Rex listeims for 
Lexi’s bark and opens the door for her. 
“Sleep deprivation has been driving me mad,” says 
David. “It’s all down to a new member of the family, 
our new dog. She [Lexi] barks at night when she’s 


left out. She barks early in the morning when she’s 
left in.” 


David decided to build a bark-activated automatic 
door opener. A noise detector circuit is wired to the 
input of the Raspberry Pi to detect barks. A motor 
driver circuit drives the actuator that unlocks the 
door, and a weight and pulley system swings the door 
open when it’s unlocked. 

“T picked up the audio detection circuit in Maplin as 
a DIY kit,” David tells us. “I probed the audio 
sensor with a voltmeter; when the volume 
into the microphone was at a decent level, | 
Saw about 3-3.5 volts at one point, so I hooked 
that directly up to the GPIO on the Raspberry 
Pi, and it worked beautifully. 

“T had a few pieces of metal lying around, 
and an angle bracket which got around the 
concrete blocks nicely to meet the door lock. 

I added a couple of bearings to reduce the 
friction on the mechanism, I didn’t want to 
burn out the actuator. When it was built it 
was Still a little stiff, so I greased it up and it 
was then moving nice and smoothly.” 

Now whenever Lexi barks, the door 
opens automatically to let her into the 
house (magpi.cc/28KAM3z). 


Left The door is connected to a weight via a pulley 
system. When the actuator moves back, the door 
automatically swings open 
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RICHARD HOPKINS 


Richard Hopkins is an IBM 
Distinguished Engineer in the UK. 
He is the co-author of a book called 
Eating the IT Elephant. 


ended up building his version of K9 with motors from 


One of our readers has built 


an electric scooter. “The servos used for the tail and y 
Doctor Who’s robot dog ears are simply not powerful enough to move a fairly YOU LL 
substantial robot around,” explains Richard. So he NEED 
hat if you want to build a pet tech project, but uses e-scooter motors connected to an H-bridge to 
don’t have a pet° Well, you could use your move the robot around. > E-scooter motors 
Raspberry Pi to build your very own dog. Kg is a lot smarter than most robots. “One Sipconcore 
And if you’re going to build a dog, why not go with of the original goals of building K9 was that he 
the best robot dog that ever existed: Doctor Who’s K9° _ should have a Siri-like function for when he’s not fae 
Richard Hopkins is an IBM Distinguished Engineer, a remote presence robot,” Richard says. “Apple As orl 
and he’s spent a lot of time bringing K9 to life. “Most has put quite a bit of money into developing Siri, 
people would probably start with something simple, so getting an equivalent function working on a 
but that’s not my style,” says Richard. “Sink orswim. _Piis a big ask.” Fortunately, Steven Hickson has 
My first robot will be as near a facsimile of Doctor created a very clever voice command capability, 
Who’s dog Kg as 1 am capable.” specifically tuned for the Pi, as part of the PiAUISuite 
The Kg build is based on the K9 schematics fromthe (magpi.cc/22MLXNr). Behind the scenes, it uses 
Doctor Who props department, and made from MDF. Google voice recognition and Google Translate text- 
It’s a work in progress, and detailed instructions can to-speech software to enable the Pi to understand 
be found on Richard’s blog (magpi.cc/28J6021). simple spoken commands and respond using voice. 
Richard has also = “lve managed to get the basics working,” 
purchased several | | reveals Richard. “You can now hold a conversation 
remote-control K9 \ _ with Kg, even if there are some embarrassing pauses 


toys from eBay, but while he thinks.” 


The Raspberry Pi inside 
controls K9 and powers 
the dashboard screen on 
his side. It also connects 
to the Pi Camera sitting 
behind his red eyes 


Kg features Sharp infrared 
proximity sensors attached 
to his rotating ears. These 
look forwards and to the 
sides, and enable Kg to 
navigate his environment 


Inside the body are 

motors recycled from 
The robot uses Siri-like N an electric scooter. 
voice analysis to hold ; These have enough 
conversations and act on 3 . power to move the 
his master’s commands 5 heavy robot around 
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The Beetlecam is mounted on the roof of = 
the elephant beetles’ tank using Velcro tabs * 


BEEIL 


Monitoring nocturnal insects with a Raspberry Pi Camera 


Elephant beetles may not be the most strokeable pets, in the morning they have rearranged the branches 


but Will McGugan is a freelance software developer in their tank.” 

in Edinburgh who loves them all the same. “These Will wanted to make use of the Pi’s Camera Module 
insects are mostly nocturnal,” he tells us. “During to create a webcam. “I also wanted to be able to create 
the day, they tend to burrow under their bedding time-lapse movies, because I didn’t want to watch 12 
material or hang out on a branch. But during the hours of video to see what they get up to at night.” 
night, they can be quite active. I know this because The result was Beetlecam (magpi.cc/22MLURG). 


r. 


Pa 


SNIFFUR 


Keep track of your pet, using beacons 
to triangulate their position 


We looked at Matt Reed’s Sniffur project back in 
issue 42, and it’s still an impressive piece of kit. 
Sniffur uses a Bluetooth beacon and Raspberry Pis 
to triangulate the position of Bean, the dog at Matt’s 
office. But all dogs like to get out and play. “When 
[greyhounds] do, they’re very hard to catch because 
they’re so fast,” says Matt. “The need to know where 
she is at any moment and see if she’s close to the 
front doors is the reason Sniffur was built.” 

Three Raspberry Pis are used to monitor the beacon 
device attached to Bean’s collar (magpi.cc/28L5Nle). 


Left A beacon is attached to Bean's collar, 
and three Raspberry Pi devices are used 
to triangulate the dog's position 
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cat's bowl 
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PI-POWERED 
CAT FEEDER 


Keep your cat fed with this 
automated cat feeder 


Anybody with a cat knows how useful a cat feeder is. 

David Bryan took things one step further by building 

this Pi-powered cat feeder (magpi.cc/28KAD01). 
“It’s simple,” says David, “and can be easily 

assembled in about 4-6 hours once you have 

all the parts.” 
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CATWHEE 


Build a giant hamster wheel 
for your moggy 


PET TECH PROJECTS 


We looked at Jasper’s Cat Exercise Wheel in issue 

45, and it’s still one of the coolest pet tech projects 
around. This giant mechanised wheel uses a laser 
pointer to attract cats, and then a motor turns the 
wheel (youtu.be/dbPTwewy1SA). The Pi gathers data 
on motion and reports back via a web interface. 


Keep your cats trim with 
this smart exercise wheel , 


PE TBOT 


Keep an eye on your pet with 
this open-source robot 


PetBot (petbot.com) is the only commercially available 
project here, but don’t worry: it’s all open-source, and 
you’ re free to use the source code to build your version 
(or buy a pre-built kit). PetBot trundles around the 
floor of your house and enables you to interact with 
your pets from afar. It comes with a remote-controlled 
webcam, image recognition software, and treat 
dispenser, and is powered by the Raspberry Pi. 


Play with your 
pet remotely with 
PetBot, a robot 
designed for 

pet interaction 


= 
oan 
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Waker 
days 


It's 


Simple, easy 
to use, and 


looks great 
Average Man 


MOTLOZERO 


This Zero-size board lets you control up to four motors independently 


ichard Saville, who blogs 
as the Average Man 
(magpi.cc/1Ypo4ez), 
came up with the design for the 
MotoZero while watching his 
favourite TV show, Sons of Anarchy. 
That biker influence has led to the 


it coolest-looking motor board we’ve 

ever seen, resembling an exposed 
With numerous, ; baie 
configurable engine with its chunky terminals 
outputs and and twin socket-mounted driver 
inputs, this chips. The attention to detail even 
fully featured 


extends to some piston graphics 
on the board. That’s right, by 
the way: you get not one but two 
motor driver chips, enabling the 
a, MotoZero to control four motors 
w@ independently. While the L293D 
chips used here have been around 
quite a long time, they do the job 
well enough, as they are fairly 
low-powered motors. 


Zero-size motor 
board is ideal 
for complex 
projects. 


£13 / $18 
magpi.cc/1p9wGaA 
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Design considerations 
It’s obvious that a lot of thought 
has gone into the MotoZero’s 
design. The terminal blocks are 
high-quality and chunky, making 
it easy to connect your motor 
wires; their screw-heads are a 
decent size, too. These blocks 
should certainly stand up to 
prolonged use. The main terminal 
blocks are grouped in pairs, after 
sliding the ridge edges together, 
to avoid them being easily twisted 
out of place. Their positioning 

on either side of the Zero-sized 
board is ideal for powering the 
wheels on each corner of a robot. 
A fifth terminal block is supplied 
for the wires from your chosen 
power supply; alternatively, you 
could solder them directly to 

the board holes. One caveat to 


mention here is that, due to its 
low cost, the MotoZero board 
lacks any protection from reverse 
polarity, so you need to make 
sure that your battery pack is 
connected the right way round! 
Since the MotoZero is supplied 
in kit form, you’ll need to assemble 
it, which involves a fair amount 
of soldering. While some people 
might be put off by this, Richard 
reckons it’s all part of the fun of 
playing around with electronics. 
Depending on your soldering skills, 
it should take 30-60 minutes 
to put together; helpfully, the 
comprehensive PDF manual 
contains a step-by-step assembly 
euide illustrated with photos, while 
the board itself is clearly marked 
with component positions and 
labels. It’s recommended to solder 
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MOTOR CONTROL PINS 


The MotoZero allocates three GPIO pins to each of the four motor 
channels, as follows... 


Enable pin - 5 
Positive — 24 
Negative - 27 


Enable pin — 17 
Positive — 6 
Negative — 22 


Enable pin —- 12 
Positive — 23 
Negative — 16 


Enable pin - 25 
Positive - 13 
Negative - 18 


on the 40-pin GPIO header first, 
followed by the two chip sockets, 
then the four motor connection 
terminals, capacitor, and optional 
fifth terminal block. Just slot the 
two L293D chips into the sockets 
and you’re good to go. 


Twin drivers 

Once the MotoZero is assembled, 
it’s ready to control connected 
motors once slotted onto a 
Raspberry Pi. Incidentally, while 
the MotoZero’s form factor is a 
perfect match for the Pi Zero, and 
Zero-sized robots, it can be used 
with any 40-pin Pi model. 

As mentioned, the L293D driver 
chips are old technology, but still 
a good choice here since they are 
low-cost — thereby helping to keep 
the overall price down — and able 
to handle a wide range of voltages: 
from 4.5V to 36V. Handily, they 
also have built-in overheating 
protection and feature integrated 
flyback diodes to prevent damage 
from sudden voltage spikes from 
the motors. And even if they do get 
damaged, the socket mounting on 
the MotoZero makes them a cinch 
to replace. 
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One slight downside to using 
L293D chips is that they only 
Supply 600mA continuous current 
per channel (i.e. motor). This 
means that you will need to 
use motors with a Stall current 
not much higher than that: the 
manual states that you can get 
away with around 700mA, so long 
as you’re careful to avoid stalling 
the motor and also keep an eye 
on chip temperature. 

When it comes to controlling 
them, each motor channel is 
assigned three of the Pi’s GPIO pins 
(which have been chosen carefully 
to avoid using any with special 
functions such as PC, SPI, and 
UART). While the first two pins are 
turned HIGH/LOW or LOW/HIGH to 
make the motor turn forwards or 
backwards, as per usual, the third 
pin acts as a master on/off switch. 
While you might well wonder what 
the point of this ‘enable’ pin could 
be, one benefit is that it can be 
used with pulse-width modulation 
(PWM) to control the speed 
independently of direction. 

Although the Python coding 
process will be similar to that 
for most other motor boards, 


one major plus point is that the 
MotoZero is getting its very own 
output device class in the excellent 
GPIO Zero library (although at 

the time of writing, Ben Nuttall 
was still working on this), which 
should make it even easier for 
robotics novices to control motors 
with very few lines of code. Note, 
however, that if you want to attach 
any robot sensors — such as a line 
follower or ultrasonic distance 
sensor — you’ ll need to either wire 
them directly to pins by using a 
stacking GPIO header (instead of 
the one supplied), or stack a HAT 
underneath the MotoZero. 


fast word 


While it lacks some of the 
advanced functionality of 
more expensive motor boards, 
including servo control and 
GPIO inputs/through-holes 


for sensors, the MotoZero 
offers great value for money, 
looks very cool, and has the 
unusual ability to control four 
motors independently. 
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Maker 
Says 
Add 
motors to 
(almost) 
any Pi Zero 


project 
Atronix 


PICOBORG 


Another simple 
motor controller 
that can be 
used for robots 
or other motor 
tasks. It takes 
up more GPIO 
pins, though. 


piborg.org/picoborg 
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PZM — Pl ZERO 
MOTOR SHIM 


Not quite a motor board like the MotoZero, this little shim 


does let you control some motors with the Pi Zero 


e’ve seen some tiny 
add-ons for Raspberry 
Pis and even the Pi Zero 
in the past, but this motor shim 
from 4tronix has surprised us the 
most with its size. About as long 
as three micro SD cards laid end 
to end and not much wider (it’s 
38mm x 16mm), this tiny bit of PCB 
promises the ability to control two 
motors while taking up very little 
Space in your project. 

The shim comes as a kit you 
need to construct: the two motor 
terminals, a power terminal, anda 
couple of methods of attaching it to 
the GPIO ports. It does require a little 
bit of soldering, but even the most 
novice wielders of a soldering iron 
Should have no problem with this 
and be done in about 20 minutes. 

Due to how thin the board is 
(0.8mm, which is tiny), you can 


easily mount it directly to the Pi 
Zero if you wish. It does come 
with some more straightforward 
methods, as mentioned above: 

a female header so you can attach 
it to a Pi Zero with a set of 40 
GPIO pins attached, or a male 
header so it can just slot through 
the empty pins. It only needs six, 
as well, and uses the last six pins 
so that it doesn’t take up the 5V 
and 3V3 pins at the front of the 
GPIOs. It’s quite clever, although 
it does mean you need proper 
external power for it, like most 
motor boards. 

The code for the board is quite 
simple, much like for the other 
4tronix boards. Getting the 
Python module from their site 
lets you import it and give such 
commands as pzm. forward and 
pzm.spinRight, and also control 


the speed. All very easy to use 

and implement into your project. 
We feel this particular shim goes 
beyond robot projects; after all, 
there are plenty of great dedicated 
robot-centred motor boards. 
Motors can do more than turn 
wheels, after all, although if you’re 
making a particularly tiny robot, 
the shim should easily do for that 
as well. 


fast word 


It barely costs more than the 
Pi Zero, yet it lets you make 
tiny robots or add motors 


to any sort of Raspberry 
Pi project. The minimal 
assembly is great as well. 
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EXPLORER 
HAT PRO 


While not as 
easy to use, 

it includes 

two H-bridge 
motor drivers, 
analogue inputs, 
built-in LEDs, 
touch pads, 

and capacitive 
clip pads. 


£18 / $23 
magpi.cc/10AKy46 
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ne obstacle that newcomers 

to Raspberry Pi physical 

computing come up against 
is trying to figure out which pin 
does what on the Pi’s GPIO header, 
particularly since they’re not 
labelled. Previous solutions have 
included printing out a GPIO pin 
reference guide on such items as 
rulers and key-rings. Alternatively, 
users could just refer to an online 
diagram, such as at pinout.xyz. 
Even then, you still need to count 
down the two lines of pins on the 
Pi to locate the one required, which 
increases the chance of a potentially 
damaging wiring mistake. 

Enter the RasPiO Pro HAT. 
Designed by Alex Eames of rasp1.tv, 
it makes using the GPIO pins a 
whole lot easier. Around the edges 
of its built-in breadboard are 
female header sockets connected 
to the Pi’s GPIO pins, arranged 
and labelled in numerical (BCM) 
order. So, for instance, if you want 
to hook up acomponent to GPIO 
18, you simply plug its jumper wire 


‘ seal jews 
oid ere 


Waker 
days 


Putting 
your ports 
In perfect 
order and 
protecting 
them from 


human error 
RasPi0 


PRO HAT 


Is this electronics prototyping HAT the easiest-to-use ever? 


into that labelled socket: no more 
pin-counting! Nor is any extra 
software required. The HAT works 
perfectly with GPIO Zero, as well as 
other libraries. It’s such as simple 
solution, it’s a wonder no one’s 
thought of it before. 

The third female header 
comprises Six extra connections 
apiece for 3V3 and GND; this comes 
in handy, since the mini 72-point 
breadboard doesn’t feature the 
‘+? and ‘—’power rails of larger 
versions. In addition, you won’t 
need quite so many jumper wires to 
power/ground all your components 
as they are, in effect, wired straight 
to the relevant GPIO pins. You may 
need to stock up on a few more 
male-to-male cables, though. 

The other big advantage of the 
RasPi0 is that it makes prototyping 
a lot safer, since a protection 
circuit with a 330Q resistor and 
3V3 Zener diode is built into each 
GPIO port. This means that you can 
use LEDs without extra resistors, 
and you won’t damage your Pi’s 


GPIO by wiring something up 
incorrectly, although you still need 
to take care not to directly short 
3V3 or 5V power to GND! One side 
effect of this protection circuitry 

is that some components requiring 
more than the 10mA limit, such 

as buzzers, may be underpowered; 
fortunately, a line of unprotected 
through-hole ports is included for 
this purpose. 


fast word 


The RasPiO Pro HAT really 
does make electronics 
easier, eliminating the need 
for counting GPIO pins 
while also protecting them 
against incorrect wiring. 


About the only drawback is a 
lack of room on its half-size 
breadboard, but if you do need 
extra space for components, 
you could easily hook it up to 
another breadboard. 
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Maker 
Says 
A fully 

functional 

low-cost 


robot 
Chickbot 


CAMJAM 
EDUKIT #3 


Another cheap 
beginner's 
robot kit, it's 
supported in 
GPIO Zero, but 
doesn't come 
with a chassis. 


£17 / $25 
magpi.cc/28KDWS9S 
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CHICKBOT 


CHIC 


30 1 


RASPBERRY PI KIT 


A very DIY robot that’s designed to be fun to program and easy to assemble 


t’s been a little while since 
we’ve seen a full robot kit 
in the magazine, rather 
than just boards and controllers. 
The Chickbot is an educational robot 
kit aimed squarely at beginners, 
with a bigger focus on programming 
the robot than other aspects of it. 
Due to this programming focus, the 
actual physical chassis itself is very 
simple and bare-bones, requiring 
very little to actually build it from 
the supplied kit. 

The build itself is very simple, 
with not even a screwdriver 
involved to put the chassis 
together until you start wiring 
in the motor cables. It’s so low- 
tech, the tyres for the wheels 
are made from cut-up balloons, 
which are a bit of a nightmare to 
put on properly; this probably 


does help to keep the cost down 

on the overall kit, though. We put 
it together in about an episode- 
and-a-half of Pokémon, so roughly 
half an hour, with the only really 
tricky bit being making sure all 

the right motor cables were going 
in the correct slot. It does come 
with some instructions, but a more 
thorough walkthrough guide is 
provided online that was of slightly 
more use to us. 


Speed build 

The build is a little flimsy and 
we’re mildly concerned over 

how well the robot will fare 

with beginners playing around 
with it. It’s not like it’s going to 
completely shatter if you hit a wall 
at full speed (it’s not particularly 
fast anyway), although if you find 


yourself doing this, sticking a little 
foam tactically around the edge 
is pretty simple and quick. 

A lot of the learning and 
building that’s part of Chickbot 
is hosted on the website, and 
at the time of writing it’s still 
under construction. A series of 
programming tutorials for the 
Raspberry Pi version are still being 
written, although it will guide you 
through a very basic program to 
get the LED and buzzer working in 
a preprogrammed manner. These 
tutorials are written in Python and 
use the RPi.GPIO library instead 
of GPIO Zero, and the robot needs 
to be programmed completely 
manually rather than using any 
supplied module or library. There’s 
at least a well-commented Python 
Script to get you going; however, it 
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can be a little tricky for a beginner 
to parse effectively and learn from. 
Hopefully, when the tutorials are 
properly finished, you’ll be able to 
truly exploit the educational and 
robotic powers of the Chickbot. The 
Arduino version is fully supported 
right now, with several tutorials 
on how to get the robot working, 
moving, and singing. The tutorials 
are useful and explain what 
they’ re doing in detail, so you’1l 
definitely learn in the process. 
So far, this level of explanation is 
present in the available Raspberry 
Pi documentation, but it may bea 
little while before this full level of 
support is available on the website. 
As for using it with a Raspberry Pi, 
really your best bet is a Model A+ or 
a Raspberry Pi Zero. The robot isn’t 
very fast, so you could feasibly hold 
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a full-sized Pi as it trundles along, 
but a full-sized Pi rests awkwardly 
on top of the robot. The Zero and A+ 
fit a bit more snugly on top and don’t 
significantly add to the weight of the 
chassis. While the tutorials suggest 
you hook it up to a monitor so you 
can program it manually in Python 
before running the script, we suggest 
prepping the Pi first to make sure you 
can SSH into it. That way you don’t 
have to worry about cables running 
off the robot as you test it out, 
although for the lights and buzzer 
programs it’s safe to hook it up. 


Great potential 

Overall, the Chickbot is an 
interesting kit. We like how cheap 
it is and its focus on programming; 
however, for the programming side 
it does need the documentation to 


ss 
“ 


ih, 


make it truly worthwhile. It must 
be said that it’s still considered 
largely a beta product, so it will 
eet this documentation; we’ve 
been told some more will be up 
by the time we go to press. If 

this sounds like a product you’re 
interested in, then keep an eye out 
on the Chickbot website to figure 
out when the documentation is 
in a state that’s ready for you. 


A great little idea, but right 
now the Raspberry Pi version 
doesn't have quite enough 
documentation to make it as 


educational as it wants to be. 


KK 


We like how cheap 
itis and its focus 
on programming 


There'sa 
few components 
to assemble, but 
you can put them 
together pretty 
quickly with 
little hassle 
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RASPBERRY PI 
BESTSELLERS 


Dr Downey's ‘Think Like A...’ series is 
available as O'Reilly paperbacks, free 
Green Tea PDFs, or LaTeX source 


THINK PYTHON, 
2ND EDITION 


Author: Allen Downey 
Publisher: O'Reilly 
Price: £29.99 

ISBN: 978-1491939369 


magpi.cc/28R52xq 


The highly regarded - and 
extremely popular - programming 
introduction, updated for Python 3. 
Readable and useful guide with er 
nice examples, exercises, and 

good debugging information. 

Features in Coursera MOOC. 


THINK BAYES  —__-— 


Authors: Allen Downey 
Publisher: O'Reilly 
Price: £19.99 

ISBN: 978-1449370787 
magpi.cc/28R57kw 


Teaches Bayesian analysis 
with Python code instead of 
calculus, making it easier to 
understand for programmers, 
and providing a path from 
simple to real-world examples. 


THINK COMPLEXITY: 
COMPLEXITY SCIENCE 
AND COMPUTATIONAL 


MODELING —— 


Authors: Allen Downey 
Publisher: O'Reilly 
Price: £26.50 

ISBN: 978-1449314637 
magpi.cc/28R56NH | 


Downey covers complexity 
science, embracing “data | 
structures and algorithms, 
intermediate programming in 
Python, computational modelling, 
and the philosophy of science” 
along the way! Concise, 
challenging, enjoyable. 


oral 
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P] 2 OWNERS: 
WORKSHOP 
MANUAL 


Author: Gray Girling 
Publisher: J H Haynes & Co 
Price: £18.99 

ISBN: 978-1785210730 
magpi.cc/28R5mMs 


Once upon atime, 
when cars had 

no computers, and were simple 
enough to maintain and repair by 
any competent home mechanic, 
Haynes manuals were first 
choice for how to work with any 
automobile. Now, while modern 
cars are too difficult to work on, 
but computers are heading back 
to the DIY ethos of the 1980s, 
Haynes’ ongoing diversification 
efforts catches up with multicore 
Pis and the Zero. Not the Pi 3 
though, but pity the poor 
publisher trying to keep up with 
Foundation developments. 


BAPERL PY iaUN 
PROGRAMMING 


Author: Michat Jaworski, Tarek Ziadeé 
Publisher: Packt 
Price: £27.58 

ISBN: 978-1785886850 
magpi.cc/28R5KKQ 


Adding a co-author to Packt’s 
interesting but outdated 
euide to Python best practices 
for intermediate developers has 
resulted in a series of improvements 
to readability and code examples, 
and an update to Python 3 along 
with updates to tools to manage 
your code. The first chapter sums 
up the current status of Python use, 
ensuring you’re comfortable with 
utilities such as pip and virtualenv, 
which nowadays are standard tools 
of Python coders. 

Focusing strongly on 
“reliable code deployments and 
concurrency”’, and thus aimed 
at web developers and back-end 
engineers in particular, Jaworski 


Expert Python Pr, 


San ones Colton 


Mchat Abwtren) 
irek Pay 


The updated publication retains 
Haynes’ clear layout and practical 
cookbook approach: this is a book 
to be dipped into and quickly 

accessed for projects and 

answers, with the detailed 

contents sections squeezed 

into a double-page spread for 
instant access to all recipes. 
The ensuing introduction 
places the Pi squarely in the 
BBC Micro tradition, and ably 
and concisely introduces the 
philosophy of Free Software. 

Recipes are grouped into 
software and hardware sections, 
leading onto projects (‘Meal 
Plans’) that are both useful (such 
as a media centre) and a platform 
for further learning; this includes 
a game of Snake as an immersive 
follow-up to the useful earlier 
Python introduction. A good Pi 
intro and ongoing reference. 


Score 


and Ziadé dive into best practices 
in syntax at various levels, from 
iterators, generators, 
and descriptors, 
to class-level 
improvements and 
metaprogramming. 
The authors then tackle 
eood naming practices, 
and packaging and 
deploying code. 
Documentation, 
test-driven development, and 
managing your code follow. Then 
locating bottlenecks, “the three 
rules of optimisation”, and writing 
extensions in C, C++, Cython or 
Pyrex, along with the section 
on concurrency, will squeeze 
performance out of a language that 
optimises developer time over CPU 
time. Useful design patterns round 
off a book which will help many less 
experienced Python programmers 
step up to the next level. 


ogramming 


Score 
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MAKE: 
ACTION: 


Make: 
Action 


Author: Simon Monk 
Publisher: Maker Media 
Price: £23.50 

ISBN: 978-1457187797 
magpi.cc/28R5VpP 


This book is all about 
bringing action - 
music, light, and sound ~— to the Pi 
and the Arduino. Both boards are 
treated fairly equally, and it gives 
a good appraisal of which types 
of projects are best suited to one 
board or the other, although the 
low-cost Pi Zero changes the cost 
argument in the Pi’s favour. 

If you only have a Pi, there’s 
plenty here to do and learn 
from: Monk’s latest work is all 
about the dynamic possibilities 
of electronics. The projects are 
both interesting in themselves, 
and a good source of learning 


THE ACCIDENTAL 
SYSADMIN 
HANDBOOK 


Author: Eric A Kralicek 
Publisher: Apress 
Price: £27.99 

ISBN: 978-1484218167 
magpi.cc/28R6905 


Accidental 
sysadmin is 
the term for 
anyone who has ended up with 
responsibility for an office’s 

IT systems after unadvisedly 
revealing that they know how 

to change the printer toner or 
reboot the server, then finding 

it a short step to overall control 

of all the computers. There are 
many small organisations with no 
formally trained sysadmin, and 
your reviewer has trained many 
people in this position in a number 
of community organisations across 
the country. 
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and inspiration for developing 


your own Pi projects. If you’re 


new to the Pi and electronics, 


introductory chapters cover Python 


and the GPIO library, 
then a practical look at 

electronics, moving from 

the general to the specific, 

and illustrated with 

hands-on experiments. 

Several chapters cover 

different types of motors, 
giving motion to your 
project, and including 
‘Pepe, the Dancing Raspberry 
Pi Puppet’, which returns in the 
sound chapter, gaining a voice. The 
IoT chapter sees Pepe connected to 
the internet and dancing each time 
his name is tweeted. Dr Monk’s 
clear instructions and well- 
developed projects make an ideal 
introduction to electronics with 
your Raspberry Pi. 


Score 


Many years ago, Ubuntu — 
installed on recycled hardware 
— was the most useful option, 
and today the Pi3 is idealasa 
surprisingly able small business 
server. A book needs to be 
written on this topic, but 
this is not that book: Kralicek 
instead gives a thorough 
erounding on sysadmin tasks, 
networking technologies, and 
various Servers and Services, 
but all from a rather MS-centric 
point of view. 
Nevertheless, the higher- 
level overview presented in 
most chapters will be a useful 
introduction to essential areas 
for many people who have IT 
responsibility thrust upon them. 
In conjunction with a good Linux 
introduction, this handbook could 
help you put your organisation’s IT 
in a saner and safer state, and save 
unnecessary problems. 


Score 


ESSENTIAL READING: 


COMMON LISP 


Simple syntax, multi-paradigm, and frequently 
alleged to make you a better programmer... 


Land of Lisp 


Author: Conrad Barski 
Publisher: No Starch 
Price: £33.50 

ISBN: 978-1593272814 
landoflisp.com 


The book of the website of the rock 
video (no, seriously), and the funnest 
introduction: learn Lisp “one game 
ata time”. 


Practical Common Lisp 


Author: Peter Seibel 
Publisher: Apress 

Price: £47.49 

ISBN: 978-1430242901 
gigamonkeys.com/book 


Comprehensive and well-written 
introduction that shows Lisp's power 
through a series of practical projects. 


Paradigms of Artificial 
Intelligence Programming 


Author: Morgan Kaufmann 
Publisher: Morgan Kaufmann 
Price: £43.99 

ISBN: 978-1558601918 
norvig.com/paip.html 


This 25-year-old book goes far 
beyond Al, and teaches more about 
programming than you'd believe! 


Let Over Lambda 


Author: Doug Hoyte 
Publisher: Lulu 

Price: £30.50 

ISBN: 978-1435712751 
letoverlambda.com 


TT OVER LAMBUEA 


Opinionated but essential guide 
to advanced Lisp use, focussing 
on macros - programs that write 
programs - and how to break rules. 


Common Lisp Recipes 


Author: Edmund Weitz 
Publisher: Apress 
Price: £41.50 

ISBN: 978-1484211779 
magpi.cc/28R6xM9g 


Lisp veteran Weitz takes a practical 
engineer's approach to the language, 
producing the best intermediate-level 
general Lisp reference. 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


While he won't be Sir Eben when 
he receives the honour, Lord 
Commander seems to be catching 
on in the Raspberry Pi office 


Tim's 

contributions to 
science won't be 
ending with his 
return, so there's 
always time for him 
to get knighted in 
the future 
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xplaining the whole knighthood and honours 
system in the UK can be a little tricky. 
Basically, to celebrate the Queen’s birthday, 
a selection of British citizens are chosen to be 
honoured for their contributions to British society 
in some way. Usually you hear of those that have 
knighthoods for their work in cinema (Sir Patrick 
Stewart, Dame Judi Dench, etc), or in fields such as 


business and science. There are several ranks to them, 
but they all mean that the Queen has noticed you for 
outstanding achievements. 

Eben Upton, co-creator of the Raspberry Pi and 
current CEO of Raspberry Pi Trading, has been given 
one of these birthday honours. To be exact, a CBE, or 
Commander of the Most Excellent Order of the British 
Empire. The honour is being bestowed upon Eben for 
his ‘services to Business and Education’. 


Space honour 

While we’re still in our Astro Pi special issue, we’d be 
remiss not to mention that Tim Peake also received 
an honour. Apparently he’s the first person to ever 
be honoured while in space. As his work did not take 
place in the United Kingdom (although let’s not 
argue about who ‘owns’ space), Tim received the 
Companion of the Order of St Michael and St George, 
or CMG, for his contributions to space research and 
scientific education. Having seen the way kids react 
to him and the way they’ve embraced STEM this year, 
we’d definitely say he’s earned it. 
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THIS MONTH IN Pl 


CROWDFUND 
THIS! ee - 


The best crowdfunding hits this a 
month for you to check out... 
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DARK CONTROL: 
ROBOT CONTROLLERS 


SOLAR PI PLATTER — 


it “Look at the Pi Zero. It’s small, really cheap, and sips 
power. Seems like it’s made to wander around,” reads 
the pitch on this solar power station board for the Pi 
Zero. It fits under the Pi Zero, so it leaves the GPIO pins 
clear and it comes with several more functions as well, 


ts such as three extra USB ports, a real-time clock, anda 
couple sets of motor control pins. It’s just been launched 


Earlier in this issue we covered the MotoZero, which 
allows you to control four motors from a Pi Zero-sized 
board. The Dark Control wants to let you control six 
motors from your Pi Zero. It comes in two flavours: 

a board that powers six DC motors, and another that 
controls six ESC (electronic speed control) powered 
motors. Six independent motors is a lot — most Pi 
robot boards do two or four, so six opens up a few more 
options. This could mean more wheels or just motors 
that control other aspects of a robot. You could even VAT > 
build a hexcopter with enough patience. 


something for you. 


magpi.cc/28MJr7P 
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Industrial Raspberry Pi 
| RPi Embedded Motherboard for loT 


MYPI: INDUSTRIAL 
STRENGTH IOT 


Lickst/stiaccn 


This is an interesting project: a Raspberry Pi Compute 
Module board that completely opens it up to just 
about every function you might need in a more serious 
internet-connected device. It has a 3G modem, 
Ethernet port, bulk storage, serial ports for RS232 and 
RS485, ‘easily expandable IO’, a DC power supply input, 
and industrial-style design considerations. It looks 
fairly ridiculous and all this ridiculousness will set you 
back about £99 when its launched, minus Compute 
Module, so if you’re interested you can probably 

get a bargain on its Kickstarter. 


magpi.cc/28Mv3Zm 
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at the time of writing, so give it a look and see if it it’s 


BEST OF THE REST 


Here are some other great things we saw this month 


People keep fitting Pi Zeros into 
ever smaller cases, this time an 
old Burger King Game Boy toy. It’s 
fully functional and made waves 
on /r/gaming (Reddit), where 
they predictably complained it 
was showing a GBA game. Most 
people loved it, though. 


This is a voice-controlled replica 
of the famous computer system 
from 2001: A Space Odyssey. It 
costs around $100 to build and 
this version looks lovely thanks to 
a great attention to detail. You can 
probably make sure it does open 
the pod-bay doors as well. 
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6 CNM SUMMER CAMP 


RASPBERRY 


JAM 


ue 


Want to add your get-together? List it here: 


raspberrypl.org/jam/add 


RASPBERRY JAM LEEDS 

When: Wednesday 6 July 

Where: Swallow Hill Community 
@ollesewreccde sui 

mMmagpi.cc/28K6EDD 

An event aiming to bring people 

together from across a wide area 

to discover the exciting potential 

of the Raspberry Pi computer. 


TORBAY TECH JAM 

When: Saturday 9 July 

Where: Paignton Library & 
Information Centre, 
Paignton, UK 

torbaytechjam.org.uk 

A fun, family-friendly event to 

inspire young people to take an 

interest in computing and STEM. 
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STAFFORD 

RASPBERRY JAM 

When: Wednesday 13 July 

Where: King Edward VI High 
School, Stafford, UK 

magpi.cc/28K6NqI 


A big meetup where Pi enthusiasts 
get together, share ideas, help each 


other, and most of all have fun! 


SLICE OF PI! CLUB 

When: Tuesday 19 July 

Where: Heart of Worcestershire 
College, Redditch, UK 

magpi.cc/28KJfpE 

The Slice of Pi Club is set up to 


bring like-minded people together 
to learn about the wonderful world 


of the Raspberry Pi computer. 


COVENTRY AND WARWICKSHIRE 

RASPBERRY JAM #3 

When: Wednesday 20 July 

Where: Nicholas Chamberlaine 
School, Bedworth, UK 

magpi.cc/28KJBNj 

A meetup for people who have a 

Raspberry Pi or want to learn more 

about the Raspberry Pi. 


CNM SUMMER CAMP 

When: Friday 22 July 

Where: Central New Mexico 
Community College, 
Albuquerque, NM, USA 

magpi.cc/28KJZeN 

Explore all the great things you can 

do with a Raspberry Pi. Let’s have a 

fun day of learning and exploring! 
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RASPBERRY JAM: 
SLICE OF PI CLUB 


TRURO RASPBERRY JAM 
When: Saturday 23 July 
Where: Truro College, 

Truro nWik 
magpi.cc/28KKiWS 
The first ever Truro Raspberry Jam 
to bring together enthusiastic and 
beginner Raspberry Pi users in the 
county of Cornwall. 


RASPBERRY JAM PRESTON 

When: Monday 1 August 

Where: Media Factory Building, 
Pies, WLC 

magpi.cc/28KKNAa 

Join the Preston Pi community as they 

learn, create, and share the potential of 

the Raspberry Pi computer at an open, 

family-friendly event. 


raspberrypi.org/magpi 
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PRESTON 
@ RASPBERRY JAM LEEDS 
STAFFORD 
RASPBERRY JAM 
COVENTRY AND WARWICKSHIRE 
RASPBERRY JAM #3 
~~ 
SY d =. 


DON'T MISS: 


When: Friday 22 July 


Where: Central New Mexico 
Community College, 
Albuquerque, NM, USA 


—_ Fa: es 


| — i 


_——— 


The CNM Summer Camp is a course 
held during summer break for 
middle and high school students, 

so they can learn in a college-style 
environment. Of the many courses 
on offer, you can spend a full day at 
their own Raspberry Jam, learning 
about how the Raspberry Pi works 
and seeing demos of it. For more 
details, check out the event page: 
magpi.cc/28KJZeN 
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LETTERS 


Bow 


T-shirts 


The trick with cosplay electronics is making them portable and robust - 
can't really have breadboard knocking about inside a head! 


MagPi: July 2016 


For the cosplayers 

I really liked the tutorial on doing Sans’ LED light-up 
eye in the magazine [issue 45]. I’ve been trying to 
think of a way to do cosplay electronics for a while 
now and it was great to see some inspiration from 
one of my favourite magazines. Will you do more 
tutorials on how to incorporate the Raspberry Pi into 
costumes or clothing in general? I’ve got some ideas 
for costumes (and Christmas jumpers!) that I’d like 
to use them for. 

Yu Kimura 


It was a lot of fun to make, even if there was some 
emergency soldering that had to be done at the 
convention. Finishing costumes at the hotel is 
fairly normal for cosplayers, though. We’ve been 
thinking about doing more to do with costuming 
and wearables here at The MagPi; our Features Ed 
and resident cosplayer has been planning a big build 
that we’ll probably cover in here if he ever does it. 
So hopefully, we can do more cosplay electronics 
tutorials. Actuators, buttons, sounds, displays, 
and a mic maybe? We’1] see what we can do. 
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Adventure’s end 
I’ve really been enjoying following along with Astro 
Pi and Tim Peake’s adventures over the last several 
months of the magazine but as I write this, Tim’s 
mission is coming to an end. I’m looking forward 
to seeing some of the experiment results, and my 
kids are excited to see his landing, but I’m now 
wondering if we’ll ever see as many space articles 
in The MagPi as when he was in space. Are there any 
plans to carry on your astronomical coverage? 
Regards, 
Keith C 


If you’ve read this far into the magazine, you’ve 
probably noticed that we’ve had a huge, massive 

Astro Pi feature to celebrate Tim’s return. As part of 
that article, we discussed the future of Astro Pi and 
how there were already plans to use it when French 
astronaut Thomas Pesquet makes his way up to the ISS 
at the end of the year. There are also plans for Astro Pi 
kits to be spread around the ESA countries, so hopefully 
there’ ll be experiments and competitions from them. 
We’ ll definitely cover as much as we can regarding that. 
We’ve also got another round of Skycademy coming 

up, if you like reading up on the Pi as a HAB computer, 
and we’ll be covering that as well. There’s still plenty 
of room for space content in the mag! 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving for the 
community - join in via raspberrypi.org/forums 


n the November 2015 issue of The MagPi (issue 39), 
how do I get the sprites in the article ‘Pixel art on 
Sense HAT’? 


The link takes me to a page that is one file with all the sprites. 
How do I pick out just one to test the program? 
pixster 


The file in question is a sprite sheet, created by someone not 
related to Raspberry Pi, that just holds a hundred 8x8 famous 
character sprites. For this tutorial, you’ll need to cut out the 
sprite you wish to use (in fact, there’s a step in the tutorial 
all about how to do this). Alternatively, you can find the code 
this tutorial was based on to display every single character 
from the sprite sheet here: magpi.cc/28KXAT4. There’s less 
cutting out this way! 


This is definitely not the last we'll see 


of the Astro Pi in the pages of this magazine 
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In association with 


IQaudlO 10 Pi-DAC+ 


with Pi-CASE+ smoked cases 
WWW.IQAUDIO.CO.UK 


MUST BE WON! 


WHAT NOUN IS 
OMMONLY USED 
TO DESCRIBE HI-FI 
ENTHUSIASTS? 


: pat? 


The IQ Audio Pi-DAC+ 


delivers outstanding sonic 
performance and full HD audio 


Also available at: pi-shack.com 


w 
s 
w 
~ 
al 
eS 
i. 
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, 
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Tell us by 25 July 
for your chance to win! 


Simply email competition@raspberrypi.org 
with your name, address and answer! 


Column | THE FINAL WORD 


, product ecosystem 


he success of Raspberry Pi as a computer has 

created a large market for accessories. That 

market strengthens Raspberry Pi’s value, 
which makes for a wonderful positive feedback loop 
that amplifies and enhances the world of Raspberry 
Pi for everyone. I’ve been thinking a lot about the 
Raspberry Pi ecosystem and how to find success in 
it. While there are many ways to be a part of this 
ecosystem, such as creating content or selling kits, 
I especially like the market for accessories. 

HATs are a particular favourite of mine. If you’re 
not familiar them, HAT stands for Hardware 
Attached on Top. It’s the specification for Raspberry 
Pi add-on boards which can be placed on the GPIO 
pins. A Raspberry Pi HAT is often a basic extension of 
the capabilities of the product. It can add functionality 
like motor control, analogue input, or motion sensors. 
It can be used to interface the Raspberry Pi with other 
technologies like a wireless transceiver, e-ink display, 
or high-end audio devices. HATs make it easy for you 
to use other hardware with Raspberry Pi without the 
need to create a mess of jumper wires, components, 
and data sheets. 

Not all HATS are one-trick ponies. Some do a 
bunch of different things. For example, Pimoroni’s 
Explorer HAT Pro has capacitive touch pads, RGB 
LEDs, analogue input, motor drivers, and a convenient 
breadboard on top. And our own Sense HAT has an 
8x8 RGB LED matrix, joystick input, and sensors 
for motion, orientation, acceleration, temperature, 
pressure, and humidity. With these multipurpose 
HATs, you can explore a lot of different project ideas 
without a lot of fuss. 

I also like HATS that make Raspberry Pi more 
useful to other communities of enthusiasts. Those 
of you who are interested in building your own 
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MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


SUCCESSFUL 
" ACCESSORIES 


From HATs to cases, Matt Richardson explores the Raspberry Pi 


flying drone might like Navio 2, which adds a lot 

of the necessary functionality to make your own 
autonomous drone with Raspberry Pi at its core. 
With Navio 2, drone-building hobbyists can leverage 
the power of Raspberry Pi and its community for 
their own projects. 


Useful and stylish 

Beyond HATs, there are many other kinds of useful 
accessories, such as cases, adapters, and mounts for 
Raspberry Pi. Just a few days ago, I came across a new 
product called ZeroView by The Pi Hut. It’s a suction- 
cup mount for a Raspberry Pi Zero or Model A+ anda 
Camera Module. It lets you easily point the Raspberry 
Pi Camera Module out of a window so that you can 
set up your own time-lapse rig, security camera, 

or dashcam. | suspect that this product will be very 
successful since a lot of people use Raspberry Pi in 
these sorts of applications. 

While some accessories like ZeroView are very 
clever and useful, others are fun and stylish. I’d 
recommend that you check out Raspberry Pi cases 
created by C4Labs. They’ve mastered the use of 
wood and acrylic to make some unique enclosures. 
Some are inspired by hot-rod cars, while others look 
more natural and organic. Of course, if you’re being 
practical, a case can be a very simple object, but it’s 
also a chance for a Raspberry Pi owner to add splash 
of style and fun to it. 

As Raspberry Pi enthusiasts, we’re lucky to have 
such an amazing group of entrepreneurs making 
useful, interesting, and creative products to go along 
with the world’s most famous affordable computer. 
With the strong growth of the platform, there’s an 
opportunity for more innovation and creativity in this 
space and! can’t wait to see what happens next! 
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Raspberry Pi gets a new home 


Industrial automation with Raspberry Pi just got easier 


The new RPI-BC enclosure is designed specifically to accomodate Raspberry Pi 
computers. The DIN rail or wall mountable enclosure provides access to all ports, 
GPIO pins and SD card without removing the lid. Ideal for all industrial automation 


projects. 


For additional information call 0845 881 2222 or visit phoenixcontact.co.uk 
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LEARN 10 CODE 
WITH SCRATCH 


Get started today for MAKE GAMES AND APPLICATIONS 


just £2.99 / $3.99 your haspberry Pi 


MéigPt 


Available on the 


p Store 


® From the makers of the 
official Raspberry P1 magazine 


GET IT ON 


>» Google Play ind it on 


The ® 
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[ LEARN TO CODE WITH SCRATCH ] | G ItC | U D D 


The 
Tabs: Click the tabs 
to choose between 


ESSENTIALS changing a sprite's 
scripts, costumes, 


or sounds 


The Blocks Palette: 
This is where you 
find the commands 
to control your 
sprites. Click the 
rounded buttons 


at the top to 
switch between 
the different types 
of blocks - - - 
WI | | S C R A [ C ; ; Scripts Area: Assemble The Sprite List: Select your sprites The Stage: Watch 
your programs here by here, so you can change their scripts or your sprites move 


LEARN TO 
¢ < ‘ a WITH 


dragging blocks in from costumes. Click the Stage in the Sprite and interact here 
$ $ the Blocks Palett id List to add scripts to it or chi it 
Fancy yourself as Disney or Miyamoto? Whether your feinlog thantipeaiver aa 


inspiration is Mickey Mouse or Mario, Scratch helps 
you to bring your creations to life... 
build your first program to move the Scratch cat around the 
screen using the up, down, left, and right cursor keys. When 
you learn more later, you’ll be able to develop this simple program into 
an art package with the cat as the pen, a game (where should the cat 
go°), or anything else that needs keyboard-controlled movement. As 
you work through this chapter, you’ll learn how the Scratch screen is 
carved up, so you can easily find what you need as you build the other 
projects in this book. 
If you’re itching to write your own games or start building your own 


Gc] et things moving with Scratch! In a matter of minutes, you can 


SCRATCH 


MAKE SIMPLE GAMES AND APPLICATIONS 
[ KEEP UP YOUR " Raspber: ry Pi 
TO DATE J 


Written by The MagPi Team 


Get the latest electronics projects, Scratch is the perfect place to start. 

veone Its simplicity comes from the way you select commands from a menu 
Scratch by _ Pp y ead vy : 
updating your and join them together like jigsaw pieces. Because Scratch comes with 


Cee SS Outi a collection of images and sounds, you can start making your first 
using: sudo apt- rogram in minutes 

get update && Prog ‘ —_ . 2 . . 
sudo apt-get Scratch’s power comes from the many creative ways in which you 


upgrade can combine the commands to make your own program. 


MagPi [Chapter One | [ Get Started with Scratch ] MagPi 


magpi.cc/Scratch-book 
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Serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout Pi Plus 
The Breakout Pi Plus is a useful 


and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential PI 


8 channel 18 bit analogue to digital 
converter. I?C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 

32 digital 5V inputs or outputs. |?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RICO Pi Plus 


Real-time clock with battery backup 
and 5V I°C level converter for adding 
external 5V I°C devices to your 
Raspberry Pi. 


1 Wire Pi Plus 
1-Wire® to I?C host interface with ESD 


protection diode and |*C address 
selection. 
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Now = “a 
Available | 23 ae 
for the 
Pi Zero 


SAVE 


15% 


“MagPi15” 


discount code 


GoPiGo 


Everything you need to 
build a Raspberry Pi robot! 


Connect hundreds of sensors 
to your Raspberry Pi! 


